# General Translation Platform: Créer un projet
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/project/create-project.mdx
---

title: Créer un projet
description: Crée un projet General Translation avec une clé API d’organisation. Référence de l’API « Créer un projet ».

method: POST
---

Crée un projet au sein de l’organisation associée à une clé API d’organisation. Renvoie l’ID, le nom, l’ID de l’organisation et le paramètre régional par défaut normalisé du nouveau projet.

## Vue d’ensemble [#overview]

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

**Autorisation** `org:projects:create` · **Limite de débit** Par défaut (200/min)

Utilisez cet endpoint pour créer des projets depuis votre propre automatisation. Les clés API de projet ne peuvent pas créer d’autres projets.

## Fonctionnement [#how-it-works]

* L’authentification nécessite une clé API organisation (`gtx-org-`) disposant de l’autorisation `org:projects:create`.
* L’organisation est déterminée à partir de la clé API. N’envoyez aucun ID d’organisation ou de projet dans la requête.
* Le nom du projet est nettoyé des espaces superflus et validé. Le paramètre régional par défaut est validé et normalisé, par exemple `en-us` devient `en-US`.
* Le nouveau projet hérite de la liste des paramètres régionaux autorisés et des paramètres du fournisseur d’IA de l’organisation. Les membres existants de l’organisation y sont associés.
* La requête renvoie `409` sans créer de projet lorsque l’organisation a atteint sa limite de projets.

## Requête [#request]

### En-têtes

| En-tête          | Description                                                   | Obligatoire |
| ---------------- | ------------------------------------------------------------- | ----------- |
| `x-gt-api-key`   | Clé API de l’organisation disposant de `org:projects:create`. | Oui         |
| `gt-api-version` | Version de l’API.                                             | Non         |

N’envoyez pas `x-gt-project-id`. Cet endpoint déduit l’organisation de la clé API et y crée un nouveau projet.

### Corps de la requête

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

| Champ           | Description                                                                                                                                                                    | Type     | Facultatif | Par défaut |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | ---------- | ---------- |
| `name`          | Nom du projet (de 1 à 64 caractères). Autorise les lettres, les chiffres, les espaces, les tirets, les traits de soulignement, les apostrophes, les parenthèses et les points. | `string` | Non        | —          |
| `defaultLocale` | Paramètre régional source du projet.                                                                                                                                           | `string` | Non        | —          |

Les champs inconnus sont rejetés.

## Réponse [#response]

**État** `201 Created`

| Champ                   | Description                                | Type     |
| ----------------------- | ------------------------------------------ | -------- |
| `project.id`            | ID du nouveau projet.                      | `string` |
| `project.name`          | Nom du projet validé.                      | `string` |
| `project.orgId`         | ID de l’organisation dérivé de la clé API. | `string` |
| `project.defaultLocale` | Paramètre régional source normalisé.       | `string` |

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

## Erreurs [#errors]

| État  | Cause                                                                                                                                     |
| ----- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `400` | Corps de la requête, nom du projet ou paramètre régional par défaut non valide.                                                           |
| `401` | Clé API d’organisation manquante ou non valide.                                                                                           |
| `403` | La clé n’est pas une clé d’organisation, ne dispose pas de l’autorisation `org:projects:create` ou est bloquée par une politique d’accès. |
| `409` | L’organisation a atteint sa limite de projets.                                                                                            |
| `429` | Limite de débit dépassée.                                                                                                                 |
| `500` | Le projet n’a pas pu être créé.                                                                                                           |

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