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

title: Crea un progetto
description: Crea un progetto General Translation con una chiave API dell'Organization. Riferimento API per la creazione di un progetto.

method: POST
---

Crea un progetto nell'Organization associata a una chiave API dell'Organization. Restituisce l'ID, il nome, l'ID dell'Organization e l'impostazione regionale predefinita normalizzata del nuovo progetto.

## Panoramica [#overview]

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

**Permesso** `org:projects:create` · **Limite di frequenza** Predefinito (200/min)

Usa questo endpoint per creare progetti tramite la tua automazione. Le chiavi API di un progetto non possono creare altri progetti.

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

* L'autenticazione richiede una chiave API dell'Organization (`gtx-org-`) con il permesso `org:projects:create`.
* L'Organization viene ricavata dalla chiave API. Non inviare un ID Organization o progetto nella richiesta.
* Il nome del progetto viene privato degli spazi iniziali e finali e convalidato. L'impostazione regionale predefinita viene convalidata e normalizzata, ad esempio da `en-us` a `en-US`.
* Il nuovo progetto eredita l'elenco delle impostazioni regionali consentite e le impostazioni del provider AI dell'Organization. I Member esistenti dell'Organization vengono collegati al progetto.
* La richiesta restituisce `409` senza creare un progetto quando l'Organization ha raggiunto il limite di progetto.

## Richiesta [#request]

### Intestazioni

| Intestazione     | Descrizione                                                   | Obbligatorio |
| ---------------- | ------------------------------------------------------------- | ------------ |
| `x-gt-api-key`   | Chiave API dell'Organization con `org:projects:create`. | Sì           |
| `gt-api-version` | Versione dell'API.                                        | No           |

Non inviare `x-gt-project-id`. Questo endpoint ricava l'Organization dalla chiave API e crea un nuovo progetto al suo interno.

### Corpo della richiesta

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

| Campo           | Descrizione                                                                                                                         | Tipo     | Facoltativo | Predefinito |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------- | -------- | ----------- | ----------- |
| `name`          | Nome del progetto (1–64 caratteri). Sono supportati lettere, numeri, spazi, trattini, trattini bassi, apostrofi, parentesi e punti. | `string` | No          | —           |
| `defaultLocale` | Impostazione regionale sorgente del progetto.                                                                                       | `string` | No          | —           |

I campi sconosciuti vengono rifiutati.

## Risposta [#response]

**Stato** `201 Created`

| Campo                   | Descrizione                                           | Tipo     |
| ----------------------- | ----------------------------------------------------- | -------- |
| `project.id`            | ID del nuovo progetto.                                | `string` |
| `project.name`          | Nome del progetto convalidato.                        | `string` |
| `project.orgId`         | ID dell'Organization derivato dalla chiave API. | `string` |
| `project.defaultLocale` | Impostazione regionale sorgente normalizzata.         | `string` |

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

## Errori [#errors]

| Stato | Causa                                                                                                                     |
| ----- | ------------------------------------------------------------------------------------------------------------------------- |
| `400` | Corpo della richiesta, nome del progetto o impostazione regionale predefinita non validi.                                 |
| `401` | Chiave API dell'Organization mancante o non valida.                                                                 |
| `403` | La chiave non è una chiave di Organization, non dispone di `org:projects:create` o è bloccata da una policy di accesso. |
| `409` | L'Organization ha raggiunto il limite di progetti.                                                                  |
| `429` | Limite di frequenza superato.                                                                                             |
| `500` | Impossibile creare il progetto.                                                                                           |

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