# General Translation Platform: Crear una rama
URL: https://generaltranslation.com/es/docs/platform/openapi/reference/project/create-branch.mdx
---

title: Crear una rama
description: Crea una rama, o cambia el nombre y confirma la rama predeterminada, en un Project de General Translation. Referencia de la API para crear una rama.

method: POST
---

Crea una rama en un Project, o confirma y cambia el nombre de la rama predeterminada. Devuelve el ID y el nombre de la rama resultante.

## Descripción general [#overview]

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

**Permiso** `project:files:write` · **Límite de solicitudes** Predeterminado (200/min)

Configura una rama antes de subir archivos a ella. Para consultar las ramas existentes, usa [Obtener información de la rama](/docs/platform/openapi/reference/project/branch-info).

## Cómo funciona [#how-it-works]

* Cuando `defaultBranch` es `true` y ya existe una rama predeterminada, se devuelve esa rama predeterminada. Si el `branchName` proporcionado es distinto, la rama predeterminada se renombra para que coincida con él.
* Crear una rama que no sea la predeterminada requiere un plan de pago. En el plan gratuito, una solicitud de rama no predeterminada devuelve `403`.
* En caso contrario, la rama se crea (o se reutiliza si ya existe) y se devuelve con su `id` y `name`.

## Petición [#request]

### Cabeceras

| Cabecera          | Descripción                                                      | obligatorio |
| ----------------- | ---------------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | Clave de API de Project o de Organization.                       | Sí          |
| `x-gt-project-id` | Project ID. Obligatorio cuando se usa una clave de Organization. | No          |

### Cuerpo

**Tipo de contenido** `application/json`

| Campo           | Descripción                                          | Tipo      | Opcional | Predeterminado |
| --------------- | ---------------------------------------------------- | --------- | -------- | -------------- |
| `branchName`    | Nombre de la rama; no puede estar vacío.             | `string`  | No       | —              |
| `defaultBranch` | Tratar esta como la rama predeterminada del Project. | `boolean` | Sí       | `false`        |

## Respuesta [#response]

**Estado** `200 OK`

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

## Errores [#errors]

| Estado | Causa                                                                                                          |
| ------ | -------------------------------------------------------------------------------------------------------------- |
| `400`  | Cuerpo de la solicitud no válido o `branchName` vacío.                                                         |
| `401`  | Falta la clave de API o no es válida.                                                                          |
| `403`  | La clave de API no tiene `project:files:write`, o el plan gratuito no permite ramas distintas de la predeterminada. |
| `429`  | Se excedió el límite de solicitudes.                                                                           |

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