# General Translation Platform: Créer une branche
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/project/create-branch.mdx
---

title: "Créer une branche"
description: "Créez une nouvelle branche ou renommez et confirmez la branche par défaut. Référence de l’API pour Créer une branche."
method: POST
full: true
_openapi:
  method: POST
  route: /v2/project/branches/create
  toc: []
  structuredData:
    headings: []
    contents:
      - content: Créez une nouvelle branche ou renommez et confirmez la branche par défaut.
---



## `POST https://api.gtx.dev/v2/project/branches/create`

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

Authentication: send an API key as a bearer token in the `Authorization: Bearer <key>` header.

### Parameters

- `gt-api-version` (header, "2025-01-01.v0" | "2025-11-03.v1" | "2026-02-18.v1" | "2026-03-06.v1", optional): API version. Defaults to the earliest supported version. Latest is `2026-03-06.v1`.
- `gt-project-id` (header, string, optional): Target project ID. Required when authenticating with an organization API key.

### Request body

Body (`application/json`, object):
- `branchName` (string, required)
- `defaultBranch` (boolean) Default: `false`.

### Responses

**200**: Created branch.
Response body (`application/json`, object):
- `branch` (object)
  - `id` (string)
  - `name` (string)

**400**: The request was invalid.
Response body (`application/json`, object):
- `error` (string): Human-readable error message.

**401**: Missing or invalid API key.
Response body (`application/json`, object):
- `error` (string): Human-readable error message.

**403**: Forbidden. Free plans cannot create non-default branches.
Response body (`text/plain`, string):

The complete OpenAPI 3.1 spec is available at https://generaltranslation.com/openapi.yaml.