Get a tag
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/tags/{tagId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/tags/{tagId}"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
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
Get a tag
Read a tag’s editable fields, including tags with no answers yet, and the ETag you need to update or delete the tag with the If-Match header.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
tags
/
{tagId}
Get a tag
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/tags/{tagId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/tags/{tagId}"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
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));Returns the tag configuration, including labels with no answers. Read
access is available from Growth and Agency Growth.
Response
Returns200, the resource ETag, and Cache-Control: private, no-store.
The tag object contains id, name, nullable color,
version, createdAt and updatedAt. Dates are ISO 8601 strings.
Copy the ETag into If-Match for an update
or deletion.
Synthetic request and response
curl -i "https://www.qwairy.co/api/v1/brands/$BRAND_ID/tags/$TAG_ID" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
{
"success": true,
"tag": {
"id": "22222222-0000-4000-8000-000000000000",
"name": "Pricing",
"color": "#7B3AEE",
"version": 4,
"createdAt": "2026-09-01T09:00:00.000Z",
"updatedAt": "2026-09-01T10:00:00.000Z"
}
}
Errors
An inaccessible workspace returns404 BRAND_NOT_FOUND; a missing tag
returns 404 TAG_NOT_FOUND. A resource in another team
is indistinguishable from a missing resource. See Error codes
and honor Retry-After on 429.
