List tags
Tags are free-form labels on prompts, independent of the topic tree. Where a prompt has exactly one topic, it can carry any number of tags — so tags are how you slice the same prompts a second way, by persona, campaign, funnel experiment, or anything else.
These ids are the values for the tag_id filter elsewhere on the surface.
GET /v1/brands/{brand_id}/tagsAuthorization
| Header | Type | Required |
|---|---|---|
Authorization | Bearer asky_sk_… | required |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
brand_id | uuid | required | From List brands |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | optional | Rows per page, 1 to 100. Defaults to 20. |
cursor | string | optional | Opaque cursor from the previous response. Treat it as a token, never construct one. |
Request
cURL
curl --request GET \
--url 'https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/tags' \
--header 'Authorization: Bearer <api-key>'Response
200
{
"data": [
{
"id": "1f8c2a5e-9d40-4b17-8e6a-3c05b91e7d22",
"name": "Bottom funnel",
"slug": "bottom-funnel",
"color": "emerald",
"description": "Prompts with clear purchase intent"
}
],
"pagination": {
"limit": 20,
"has_more": true,
"next_cursor": "eyJ2IjoxLCJvIjoyMCwibCI6MjB9"
},
"request_id": "req_c0a3f5d81b6e4297a4de"
}Response fields
| Field | Type | Description |
|---|---|---|
data.tags | object[] | required |
data.tags[].id | uuid | required. Use as tag_id in filters |
data.tags[].name | string | required. Display name |
data.tags[].slug | string | required. URL-safe form of the name |
data.tags[].color | string | null | Display colour token |
data.tags[].description | string | null | |
data.count | integer | required |
request_id | string | required. Also returned as the x-request-id header. Quote it when contacting support |
Errors
| Status | Code | When |
|---|---|---|
| 400 | invalid_request | A parameter is unknown or malformed. The message names it |
| 401 | invalid_token | The key is missing, malformed, or does not exist |
| 401 | token_expired | The key passed its expiry date |
| 401 | token_revoked | The key was revoked |
| 404 | not_found | The brand does not exist, or this key is not allowed to reach it. The two are deliberately indistinguishable |
| 429 | rate_limited | Over 300 requests per minute. See the Retry-After header |
Notes
Not paginated.
Last updated on