Mettre à jour un Tag
curl --request PATCH \
--url https://www.qwairy.co/api/v1/brands/{brandId}/tags/{tagId} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'If-Match: <if-match>' \
--data '
{
"name": "<string>",
"color": {}
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/tags/{tagId}"
payload = {
"name": "<string>",
"color": {}
}
headers = {
"Authorization": "<authorization>",
"If-Match": "<if-match>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: '<authorization>',
'If-Match': '<if-match>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: '<string>', color: {}})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/tags/{tagId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Tags
Mettre à jour un Tag
Modifiez le nom ou la couleur d’un Tag avec l’ETag lu en dernier dans If-Match. Les champs omis gardent leur valeur et les liens avec les prompts restent.
PATCH
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
tags
/
{tagId}
Mettre à jour un Tag
curl --request PATCH \
--url https://www.qwairy.co/api/v1/brands/{brandId}/tags/{tagId} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'If-Match: <if-match>' \
--data '
{
"name": "<string>",
"color": {}
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/tags/{tagId}"
payload = {
"name": "<string>",
"color": {}
}
headers = {
"Authorization": "<authorization>",
"If-Match": "<if-match>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: '<authorization>',
'If-Match': '<if-match>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: '<string>', color: {}})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/tags/{tagId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Met à jour les champs fournis d’un Tag. Les champs omis gardent leur valeur actuelle.
Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Sur
Branded et Non-branded sont des noms de Tags système réservés, quelle que soit la casse. Vous ne pouvez pas mettre à jour l’un de ces deux Tags système ni renommer un autre Tag avec l’un de ces noms.
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.
Fournissez au moins name ou color.
Réponse
Renvoie200 avec un objet tag de la même forme que Obtenir un Tag et un nouvel ETag. La réponse de mutation n’a pas de champ success au premier niveau. Traitez les versions comme des valeurs opaques, et non comme des compteurs.
Requête et réponse synthétiques
Lisez d’abord le Tag actuel. Cet exemple suppose que son ETag est"4".
curl -X PATCH "https://www.qwairy.co/api/v1/brands/$BRAND_ID/tags/$TAG_ID" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN" \
-H 'If-Match: "4"' \
-H "Content-Type: application/json" \
-d '{"name":"Pricing and plans"}'
{
"tag": {
"id": "22222222-0000-4000-8000-000000000000",
"name": "Pricing and plans",
"color": "#7B3AEE",
"version": 5,
"createdAt": "2026-09-01T09:00:00.000Z",
"updatedAt": "2026-09-01T10:00:00.000Z"
}
}
Erreurs
| Statut | Code | Cause |
|---|---|---|
| 400 | INVALID_REQUEST | Champs du Tag invalides, Tag système ou nom de Tag système réservé |
| 404 | RESOURCE_NOT_FOUND | Workspace ou Tag absent ou inaccessible |
| 409 | CONFLICT | Un autre Tag utilise déjà ce nom |
| 412 | PRECONDITION_FAILED | L’ETag est périmé ou invalide |
| 428 | PRECONDITION_REQUIRED | If-Match est absent |
429, respectez Retry-After ; les écritures peuvent renvoyer 503 SERVICE_UNAVAILABLE si le limiteur d’écriture est indisponible.
