Update a 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
Update a tag
Change the name or color of a tag using the ETag you last read in If-Match. Omitted fields keep their current values and prompt links are preserved.
PATCH
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
tags
/
{tagId}
Update a 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));Updates the supplied fields of one tag. Omitted fields keep their current values.
See Error codes for authentication, plan, idempotency
and server errors. On
Branded and Non-branded are reserved system tag names, whatever the case. You cannot update one of these two system tags or rename another tag to either name.
Requires an active Business, Agency Business or Enterprise plan. Use an API token with write access enabled. See Writing data for
idempotency, conditional requests and error handling.
Supply at least one of name or color.
Response
Returns200 with a tag object in the same shape as
Get a tag and a new ETag. The mutation response has no
top-level success field. Treat versions as opaque values, not counters.
Synthetic request and response
Read the current tag first. This example assumes its ETag is"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"
}
}
Errors
| Status | Code | Cause |
|---|---|---|
| 400 | INVALID_REQUEST | Invalid tag fields, a system tag, or a reserved system tag name |
| 404 | RESOURCE_NOT_FOUND | Workspace or tag is missing or inaccessible |
| 409 | CONFLICT | Another tag already uses this name |
| 412 | PRECONDITION_FAILED | The ETag is stale or invalid |
| 428 | PRECONDITION_REQUIRED | If-Match is missing |
429, honor Retry-After; writes can return
503 SERVICE_UNAVAILABLE if the write limiter is unavailable.
