Passer au contenu principal
POST
Créer un Tag
Crée un Tag sans le rattacher à aucun prompt. Pour l’appliquer, mettez à jour un prompt ou utilisez les mises à jour de prompts en masse. Branded et Non-branded sont des noms de Tags système réservés, quelle que soit la casse. Dans un workspace créé à partir de la v1.21, Qwairy crée lui-même ces deux Tags et en pose un sur chaque prompt d’après son texte. Dans tout workspace, une requête qui utilise l’un de ces noms comme name est refusée. Nécessite une offre Business, Agency Business ou Enterprise active. Utilisez un jeton d’API dont l’accès en écriture est activé. Consultez Écrire des données pour l’idempotence, les requêtes conditionnelles et la gestion des erreurs.
string
requis
Jeton bearer de votre équipe.
string
requis
Clé unique pour cette opération. Les réponses terminées sont rejouées pendant 24 heures.
string
requis
Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.
string
requis
Nom du Tag, 1 à 120 caractères après suppression des espaces en bordure.
string | null
Couleur hexadécimale facultative à six chiffres, comme #7B3AEE. null par défaut.

Réponse

Renvoie 201 avec Location, ETag et un objet tag contenant id, name, color (nullable), version, createdAt et updatedAt.

Requête et réponse synthétiques

Erreurs

Des champs invalides, ou un nom de Tag système réservé (Branded ou Non-branded, quelle que soit la casse), renvoient 400 INVALID_REQUEST ; un workspace absent renvoie 404 RESOURCE_NOT_FOUND ; un nom en doublon renvoie 409 CONFLICT. Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Sur 429, respectez Retry-After ; les écritures peuvent renvoyer 503 SERVICE_UNAVAILABLE si le limiteur d’écriture est indisponible.