Créer un Tag
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/tags \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"name": "<string>"
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/tags"
payload = { "name": "<string>" }
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: '<string>'})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/tags', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Tags
Créer un Tag
Créez un Tag réutilisable dans le workspace, avec une couleur facultative. Il n’est rattaché à aucun prompt tant qu’un prompt n’est pas mis à jour.
POST
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
tags
Créer un Tag
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/tags \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"name": "<string>"
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/tags"
payload = { "name": "<string>" }
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: '<string>'})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/tags', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));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.
Clé unique pour cette opération. Les réponses terminées sont rejouées pendant 24 heures.
Réponse
Renvoie201 avec Location, ETag et un objet tag contenant id, name, color (nullable), version, createdAt et updatedAt.
Requête et réponse synthétiques
curl -X POST "https://www.qwairy.co/api/v1/brands/$BRAND_ID/tags" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN" \
-H "Idempotency-Key: tag-pricing-001" \
-H "Content-Type: application/json" \
-d '{"name":"Pricing","color":"#7B3AEE"}'
{
"tag": {
"id": "22222222-0000-4000-8000-000000000000",
"name": "Pricing",
"color": "#7B3AEE",
"version": 0,
"createdAt": "2026-09-01T09:00:00.000Z",
"updatedAt": "2026-09-01T09:00:00.000Z"
}
}
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.
