# General Translation Platform: ブランチを作成
URL: https://generaltranslation.com/ja/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`    | プロジェクトまたはOrganizationのAPI キー。           | はい  |
| `x-gt-project-id` | project ID。OrganizationのKeyを使用する場合に必要です。 | いいえ |

### 本文

**コンテンツタイプ** `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"
  }'
```