> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Créer un workspace

> Créez un workspace au statut DRAFT. Rien d’autre ne se produit : ni analyse du domaine, ni description générée, ni run facturable avant son activation.

Crée un workspace au statut `DRAFT`. Rien d’autre ne se produit : ni analyse du domaine, ni génération de description, ni run facturable. Configurez-le, puis activez-le avec [Mettre à jour un workspace](https://docs.qwairy.co/fr/developers/endpoints/brands/update.md).

> [!NOTE]
>
> Nécessite une clé d’API active sur une offre Business, Agency Business ou Enterprise. Les clés existantes fonctionnent sans rotation. Consultez [Écrire des données](https://docs.qwairy.co/fr/developers/writing-data.md).

**Authorization** `string` *required*

Jeton bearer. Exemple : `Bearer qw-api-xxx`

**Idempotency-Key** `string` *required*

Clé unique pour cette création. La rejouer renvoie le workspace d’origine au lieu de créer un doublon.

**name** `string` *required*

Nom affiché, 120 caractères au maximum.

**domain** `string` *required*

Nom d’hôte public valide, 253 caractères au maximum, sans schéma, port ni chemin. Exemple : `acme.com`.

**description** `string`

Description facultative. Laissée vide si elle est omise ; rien n’est généré pour vous.

**languageCode** `string`

Code de langue sur deux lettres. `FR` par défaut.

**countryCode** `string`

Code pays ISO 3166-1 alpha-2. `FR` par défaut. Toute autre valeur renvoie `400 INVALID_REQUEST`.

## Réponse

Renvoie `201` avec un en-tête `Location` et l’`ETag` du workspace.

**workspace.id** `string`

Identifiant opaque du workspace

**workspace.status** `string`

Toujours `DRAFT` pour un workspace qui vient d’être créé

**workspace.version** `number`

Version actuelle, utilisée comme valeur d’`If-Match` pour les mises à jour suivantes

**workspace.url** `string | null`

URL du workspace, ou `null` si aucune n’est définie

**workspace.countryCodes** `string[]`

Catalogue de pays du workspace. Le pays par défaut vient en premier

**workspace.autoDetectCompetitors** `boolean`

Indique si Qwairy détecte automatiquement les concurrents dans les réponses

**workspace.selfHostScope** `string`

`REGISTRABLE`, `EXACT_HOST` ou `AUTO`. Une lecture peut renvoyer `AUTO` ; une écriture ne peut pas le définir

La réponse renvoie aussi `name`, `domain`, `description`, `languageCode`, `countryCode`, `lifecycleVersion`, `createdAt` et `updatedAt`.

## Requête synthétique

```bash theme={null}
curl -X POST "https://www.qwairy.co/api/v1/brands" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: create-acme-001" \
  -H "Content-Type: application/json" \
  -d '{"name": "Acme", "domain": "acme.com", "countryCode": "US"}'
```

## Réponse synthétique

```json theme={null}
{
  "workspace": {
    "id": "b1c2d3e4-0000-4000-8000-000000000000",
    "name": "Acme",
    "domain": "acme.com",
    "description": null,
    "languageCode": "FR",
    "countryCode": "US",
    "status": "DRAFT",
    "version": 0,
    "lifecycleVersion": 0,
    "createdAt": "2026-03-01T09:00:00.000Z",
    "updatedAt": "2026-03-01T09:00:00.000Z",
    "url": null,
    "countryCodes": ["US"],
    "autoDetectCompetitors": true,
    "selfHostScope": "REGISTRABLE"
  }
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `403` | `INSUFFICIENT_PLAN` | L’offre de l’équipe n’inclut pas l’accès en écriture |
| `409` | `CONFLICT` | Un workspace existe déjà pour ce domaine |
| `409` | `IDEMPOTENCY_CONFLICT` | Clé réutilisée avec un corps différent |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.