# General Translation Platform: Создать ветку
URL: https://generaltranslation.com/ru/docs/platform/openapi/reference/project/create-branch.mdx
---

title: Создать ветку
description: Создание ветки или переименование и подтверждение ветки по умолчанию в проекте General Translation. Справка по API для метода «Создать ветку».

method: POST
---

Создает ветку в проекте либо подтверждает и переименовывает ветку по умолчанию. Возвращает ID и имя созданной ветки.

## Обзор [#overview]

```http
POST https://api2.gtx.dev/v2/project/branches/create
```

**Разрешение** `project:files:write` · **Лимит запросов** По умолчанию (200/мин)

Настройте ветку перед загрузкой в неё файлов. Чтобы посмотреть сведения о существующих ветках, используйте [Получить информацию о ветке](/docs/platform/openapi/reference/project/branch-info).

## Как это работает [#how-it-works]

* Если `defaultBranch` имеет значение `true` и ветка по умолчанию уже существует, возвращается существующая ветка по умолчанию. Если переданный `branchName` отличается, ветка по умолчанию будет переименована в соответствии с ним.
* Для создания ветки, не являющейся веткой по умолчанию, требуется платный тариф. На бесплатном тарифе запрос на создание такой ветки возвращает `403`.
* В противном случае ветка создаётся (или повторно используется, если она уже существует) и возвращается с её `id` и `name`.

## Запрос [#request]

### Заголовки

| Заголовок         | Описание                                                    | Обязательно |
| ----------------- | ----------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | API-ключ проекта или организации.                           | Да          |
| `x-gt-project-id` | ID проекта. Обязателен при использовании ключа организации. | Нет         |

### Тело

**Тип содержимого** `application/json`

| Поле            | Описание                                               | Тип       | Необязательное | По умолчанию |
| --------------- | ------------------------------------------------------ | --------- | -------------- | ------------ |
| `branchName`    | Имя ветки; не может быть пустым.                       | `string`  | Нет            | —            |
| `defaultBranch` | Использовать эту ветку как ветку проекта по умолчанию. | `boolean` | Да             | `false`      |

## Ответ [#response]

**Статус** `200 OK`

```json title="Response"
{
  "branch": { "id": "br_...", "name": "feature-x" }
}
```

## Ошибки [#errors]

| Статус | Причина                                                                                                                            |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| `400`  | Недопустимое тело запроса или пустое значение `branchName`.                                                                        |
| `401`  | API-ключ отсутствует или недействителен.                                                                                           |
| `403`  | У API-ключа нет разрешения `project:files:write`, либо в бесплатном плане не поддерживаются ветки, отличные от ветки по умолчанию. |
| `429`  | Превышен лимит запросов.                                                                                                           |

## Пример [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/project/branches/create \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '{
    "branchName": "feature-x"
  }'
```