# General Translation Platform: Crear un Project
URL: https://generaltranslation.com/es/docs/platform/openapi/reference/project/create-project.mdx
---
title: Crear un Project
description: Crea un Project de General Translation con una clave de API de Organization. Referencia de la API para crear un Project.

method: POST
---

Crea un Project en la Organization asociada a una clave de API de Organization. Devuelve el ID, el nombre, el ID de Organization y la configuración regional predeterminada normalizada del nuevo Project.

## Descripción general [#overview]

```http
POST https://api2.gtx.dev/v2/projects
```

**Permiso** `org:projects:create` · **Límite de solicitudes** predeterminado (200/min)

Usa este endpoint para crear Projects desde tu propia automatización. Las claves de API de un Project no pueden crear otros Projects.

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

* La autenticación requiere una [clave de API de Organization](/docs/platform/dashboard/reference/api-keys#create-organization-keys) (`gtx-org-`) con el permiso `org:projects:create`.
* La Organization se obtiene a partir de la API Key. No envíes una Organization ni un ID de Project en la solicitud.
* El nombre del Project se recorta y valida. La configuración regional predeterminada se valida y normaliza; por ejemplo, `en-us` pasa a ser `en-US`.
* El nuevo Project copia la configuración del proveedor de IA de la Organization. Su lista de configuraciones regionales permitidas copia la lista de la Organization, excepto las configuraciones regionales del mismo dialecto que la configuración regional predeterminada; comienza vacía cuando la Organization no tiene una lista de permitidas.
* Los miembros existentes de la Organization se vinculan al nuevo Project.
* La solicitud devuelve `409` sin crear un Project cuando la Organization ha alcanzado su límite de Projects.

## Solicitud [#request]

### Cabeceras

| Cabecera         | Descripción                                             | Obligatorio |
| ---------------- | ------------------------------------------------------- | ----------- |
| `x-gt-api-key`   | Clave de API de Organization con `org:projects:create`. | Sí          |
| `gt-api-version` | Versión de la API.                                      | No          |

No envíes `x-gt-project-id`. Este endpoint determina la Organization a partir de la clave de API y crea un nuevo Project en ella.

### Cuerpo

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

| Campo           | Descripción                                                                                                                           | Tipo     | Opcional | Predeterminado |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------- | -------- | -------- | -------------- |
| `name`          | Nombre del Project (de 1 a 64 caracteres). Admite letras, números, espacios, guiones, guiones bajos, apóstrofes, paréntesis y puntos. | `string` | No       | —              |
| `defaultLocale` | Configuración regional de origen del Project.                                                                                         | `string` | No       | —              |

No se aceptan campos desconocidos.

## Respuesta [#response]

**Estado** `201 Created`

| Campo                   | Descripción                                   | Tipo     |
| ----------------------- | --------------------------------------------- | -------- |
| `project.id`            | ID del nuevo Project.                         | `string` |
| `project.name`          | Nombre del Project validado.                  | `string` |
| `project.orgId`         | ID de la Organization derivado de la API Key. | `string` |
| `project.defaultLocale` | Configuración regional de origen normalizada. | `string` |

```json title="Response"
{
  "project": {
    "id": "prj_...",
    "name": "Customer Portal",
    "orgId": "org_...",
    "defaultLocale": "en-US"
  }
}
```

## Errores [#errors]

| Estado | Causa                                                                                                                             |
| ------ | --------------------------------------------------------------------------------------------------------------------------------- |
| `400`  | La versión de la API, el cuerpo de la solicitud, el nombre del Project o la configuración regional predeterminada no son válidos. |
| `401`  | Falta la clave de API de Organization, no es válida o no es una clave de Organization.                                            |
| `403`  | La clave no tiene `org:projects:create` o está bloqueada por una política de acceso.                                              |
| `409`  | La Organization ha alcanzado su límite de Projects.                                                                               |
| `429`  | Se superó el límite de solicitudes.                                                                                               |
| `500`  | No se pudo crear el Project.                                                                                                      |

## Ejemplo [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/projects \
  -H "x-gt-api-key: gtx-org-..." \
  -H "gt-api-version: 2026-03-06.v1" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer Portal",
    "defaultLocale": "en-US"
  }'
```