Create a 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
Create a tag
Create a reusable workspace tag with an optional color. The tag is not attached to any prompt until you update a prompt or run a bulk prompt update.
POST
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
tags
Create a 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));Creates a tag without attaching it to any prompt. To apply it, update a prompt
or use bulk prompt updates.
Branded and Non-branded are reserved system tag names, whatever the case. In a workspace created from v1.21, Qwairy creates these two tags itself and sets one on each prompt from its text. In every workspace, a request that uses either name as name is refused.
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.
Response
Returns201 with Location, ETag and a tag object containing
id, name, nullable color, version, createdAt and updatedAt.
Synthetic request and response
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"
}
}
Errors
Invalid fields, or a reserved system tag name (Branded or Non-branded, whatever the case), return 400 INVALID_REQUEST; a missing workspace returns
404 RESOURCE_NOT_FOUND; a duplicate name returns 409 CONFLICT.
See Error codes for authentication, plan, idempotency
and server errors. On 429, honor Retry-After; writes can return
503 SERVICE_UNAVAILABLE if the write limiter is unavailable.
