# 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 branche, ou renommez et confirmez la branche par défaut, dans un projet General Translation. Référence de l’API pour Créer une branche.

method: POST
---

Crée une branche dans un projet, ou confirme et renomme la branche par défaut. Renvoie l’ID et le nom de la branche résultante.

## Vue d’ensemble [#overview]

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

**Autorisation** `project:files:write` · **Limite de requêtes** Par défaut (200/min)

Créez une branche avant d’y importer des fichiers. Pour consulter les branches existantes, utilisez [Obtenir des informations sur une branche](/docs/platform/openapi/reference/project/branch-info).

## Fonctionnement [#how-it-works]

* Lorsque `defaultBranch` vaut `true` et qu’une branche par défaut existe déjà, la branche par défaut existante est renvoyée. Si le `branchName` fourni est différent, la branche par défaut est renommée en conséquence.
* La création d’une branche autre que la branche par défaut nécessite un forfait payant. Avec le forfait gratuit, une requête visant une branche non par défaut renvoie `403`.
* Sinon, la branche est créée (ou réutilisée si elle existe déjà) et renvoyée avec son `id` et son `name`.

## Requête [#request]

### En-têtes

| En-tête           | Description                                                                   | Obligatoire |
| ----------------- | ----------------------------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | Clé API du projet ou de l’organisation.                                       | Oui         |
| `x-gt-project-id` | ID du projet. Obligatoire lors de l’utilisation d’une clé API d’organisation. | Non         |

### Corps

**Type de contenu** `application/json`

| Champ           | Description                                                | Type      | Facultatif | Par défaut |
| --------------- | ---------------------------------------------------------- | --------- | ---------- | ---------- |
| `branchName`    | Nom de la branche ; ne peut pas être vide.                 | `string`  | Non        | —          |
| `defaultBranch` | Définir cette branche comme branche par défaut du projet. | `boolean` | Oui        | `false`    |

## Réponse [#response]

**État** `200 OK`

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

## Erreurs [#errors]

| État  | Cause                                                                                                                                   |
| ----- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `400` | Corps de la requête invalide ou `branchName` vide.                                                                                      |
| `401` | Clé API manquante ou invalide.                                                                                                          |
| `403` | La clé API ne dispose pas de `project:files:write`, ou le forfait gratuit n’autorise pas les branches autres que la branche par défaut. |
| `429` | Limite de requêtes dépassée.                                                                                                            |

## Exemple [#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"
  }'
```