> ## 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.

# Mettre à jour un workspace

> Modifiez le nom, l’URL, les pays, la détection des concurrents et le périmètre du domaine d’un workspace, et pilotez son cycle de vie avec l’ETag dans If-Match.

Met à jour les propriétés et pilote le cycle de vie du workspace. N’envoyez que les champs à modifier.

> [!NOTE]
>
> Nécessite `If-Match`. Consultez [Écrire des données](https://docs.qwairy.co/fr/developers/writing-data.md) pour le schéma lecture puis écriture.

## Cycle de vie

| De | Vers | Autorisé |
| - | - | - |
| `DRAFT` | `LIVE` | Oui, active le workspace |
| `DRAFT` | `ARCHIVED` | Oui |
| `LIVE` | `ARCHIVED` | Oui, une fois la génération terminée |
| `ARCHIVED` | `LIVE` | Oui, le restaure |
| `LIVE` ou `ARCHIVED` | `DRAFT` | Non, renvoie `409` |

Comme dans le dashboard, l’archivage est réservé aux agences, ou à toute équipe qui a plus de workspaces actifs que son offre n’en inclut. La restauration d’un workspace archivé est refusée si un autre workspace actif suit déjà le même domaine pour la même langue et le même pays.

Activer un workspace ne démarre jamais la génération de lui-même. Lancez le travail explicitement avec [Estimer et lancer des runs](https://docs.qwairy.co/fr/developers/endpoints/runs/manage.md).

Après un changement de nom ou le passage du workspace à `LIVE`, Qwairy évalue de nouveau le Tag système `Branded` ou `Non-branded` des prompts qui en portent un.

**Authorization** `string` *required*

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

**If-Match** `string` *required*

L’`ETag` que vous avez lu en dernier pour ce workspace.

**name** `string`

Nom affiché

**description** `string`

Description, ou `null` pour l’effacer

**languageCode** `string`

Code de langue sur deux lettres

**countryCode** `string`

Code pays ISO 3166-1 alpha-2, par exemple `US`. Il devient le pays par défaut, en tête du catalogue de pays du workspace.

**status** `string`

Statut cible : `DRAFT`, `LIVE` ou `ARCHIVED`

**url** `string | null`

URL du workspace, 2048 caractères au maximum, ou `null` pour l’effacer. Le domaine du workspace ne peut pas être modifié.

**countryCodes** `string[]`

Liste de remplacement complète de 1 à 50 codes de pays en majuscules sur deux lettres : le catalogue de pays du workspace. Le pays par défaut reste en premier. Retirer un pays le retire aussi des prompts qui l’avaient sélectionné ; leurs réponses passées restent disponibles.

**autoDetectCompetitors** `boolean`

Indique si Qwairy détecte automatiquement les concurrents dans les réponses. La désactiver arrête les nouveaux ajouts automatiques ; les concurrents existants restent suivis.

**selfHostScope** `string`

Périmètre des pages et des sources du workspace : `REGISTRABLE` pour le domaine enregistrable et ses sous-domaines pertinents, ou `EXACT_HOST` pour l’hôte exact et ses sous-sous-domaines uniquement. Une lecture peut renvoyer `AUTO`, mais une écriture ne l’accepte pas.

## Réponse

Renvoie `200`, le nouvel `ETag` et un objet `workspace` avec les champs de [Créer un workspace](https://docs.qwairy.co/fr/developers/endpoints/brands/create.md#réponse), dont `url`, `countryCodes`, `autoDetectCompetitors` et `selfHostScope`.

## Requête synthétique

```bash theme={null}
curl -X PATCH "https://www.qwairy.co/api/v1/brands/$BRAND_ID" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H 'If-Match: "0"' \
  -H "Content-Type: application/json" \
  -d '{"status": "LIVE"}'
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `400` | `INVALID_REQUEST` | Champ invalide, par exemple un code pays qui n’est pas ISO 3166-1 alpha-2 |
| `403` | `INSUFFICIENT_PLAN` | L’archivage est réservé aux agences, ou aux équipes au-delà de leur limite de workspaces |
| `409` | `CONFLICT` | La restauration dupliquerait un workspace actif pour le même domaine et le même marché |
| `409` | `INVALID_STATE_TRANSITION` | La transition n’est pas autorisée |
| `409` | `RESOURCE_BUSY` | Des réponses sont encore en cours de génération ; réessayez plus tard |
| `409` | `QUOTA_EXCEEDED` | L’activation dépasserait votre limite de workspaces |
| `412` | `PRECONDITION_FAILED` | Le workspace a changé depuis votre lecture |
| `428` | `PRECONDITION_REQUIRED` | `If-Match` était absent |


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