Passer au contenu principal
POST
Créer un workspace
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.
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.
string
requis
Jeton bearer. Exemple : Bearer qw-api-xxx
string
requis
Clé unique pour cette création. La rejouer renvoie le workspace d’origine au lieu de créer un doublon.
string
requis
Nom affiché, 120 caractères au maximum.
string
requis
Nom d’hôte public valide, 253 caractères au maximum, sans schéma, port ni chemin. Exemple : acme.com.
string
Description facultative. Laissée vide si elle est omise ; rien n’est généré pour vous.
string
Code de langue sur deux lettres. FR par défaut.
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.
string
Identifiant opaque du workspace
string
Toujours DRAFT pour un workspace qui vient d’être créé
number
Version actuelle, utilisée comme valeur d’If-Match pour les mises à jour suivantes
string | null
URL du workspace, ou null si aucune n’est définie
string[]
Catalogue de pays du workspace. Le pays par défaut vient en premier
boolean
Indique si Qwairy détecte automatiquement les concurrents dans les réponses
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

Réponse synthétique

Erreurs