# General Translation Platform: Creare un branch
URL: https://generaltranslation.com/it/docs/platform/openapi/reference/project/create-branch.mdx
---

title: Creare un branch
description: Crea un branch oppure rinomina e conferma il branch predefinito in un progetto General Translation. Riferimento API per la creazione di un branch.

method: POST
---

Crea un branch in un progetto oppure conferma e rinomina il branch predefinito. Restituisce l'ID e il nome del branch risultante.

## Panoramica [#overview]

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

**Permesso** `project:files:write` · **Limite di richieste** Predefinito (200/min)

Configura un branch prima di caricarvi i file. Per consultare i branch esistenti, usa [Ottieni informazioni sul branch](/docs/platform/openapi/reference/project/branch-info).

## Come funziona [#how-it-works]

* Quando `defaultBranch` è `true` ed esiste già un branch predefinito, viene restituito il branch predefinito esistente. Se il valore di `branchName` fornito è diverso, il branch predefinito viene rinominato di conseguenza.
* La creazione di un branch non predefinito richiede un piano a pagamento. Con il piano gratuito, una richiesta per un branch non predefinito restituisce `403`.
* In caso contrario, il branch viene creato (o riutilizzato, se esiste già) e restituito con il relativo `id` e `name`.

## Richiesta [#request]

### Header

| Header            | Descrizione                                                                 | Obbligatorio |
| ----------------- | --------------------------------------------------------------------------- | ------------ |
| `x-gt-api-key`    | Chiave API del progetto o dell'organizzazione.                          | Sì           |
| `x-gt-project-id` | ID progetto. Obbligatorio quando si usa una chiave dell'organizzazione. | No           |

### Corpo

**Tipo di contenuto** `application/json`

| Campo           | Descrizione                                          | Tipo      | Facoltativo | Predefinito |
| --------------- | ---------------------------------------------------- | --------- | ----------- | ----------- |
| `branchName`    | Nome del branch; non può essere vuoto.               | `string`  | No          | —           |
| `defaultBranch` | Imposta questo come branch predefinito del progetto. | `boolean` | Sì          | `false`     |

## Risposta [#response]

**Stato** `200 OK`

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

## Errori [#errors]

| Stato | Causa                                                                                                                           |
| ----- | ------------------------------------------------------------------------------------------------------------------------------- |
| `400` | Corpo della richiesta non valido oppure `branchName` vuoto.                                                                     |
| `401` | Chiave API mancante o non valida.                                                                                               |
| `403` | La chiave API non dispone di `project:files:write`, oppure il piano gratuito non consente branch diversi da quello predefinito. |
| `429` | Limite di richieste superato.                                                                                                   |

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