Builder API
Tags
Retrieve message tags from your Chipp app
1 min read
# api # builder-api # rest # tags # labels # categorization
Tags are labels applied to messages or sessions for categorization. Tags are a small dataset, so this endpoint returns all tags at once without pagination.
List Tags
plaintext
GET /api/v1/apps/{appId}/tagsReturns all tags for the application.
Example
bash
curl "https://build.chipp.ai/api/v1/apps/YOUR_APP_ID/tags" \
-H "Authorization: Bearer chipp_YOUR_API_KEY"Response
json
{
"data": [
{
"id": "tag-001",
"name": "Bug Report",
"color": "#ef4444",
"usage_count": 23,
"created_at": "2025-05-01T10:00:00Z"
},
{
"id": "tag-002",
"name": "Feature Request",
"color": "#3b82f6",
"usage_count": 45,
"created_at": "2025-05-01T10:00:00Z"
},
{
"id": "tag-003",
"name": "Positive Feedback",
"color": "#22c55e",
"usage_count": 112,
"created_at": "2025-05-03T14:30:00Z"
}
]
}Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique tag identifier |
name | string | Display name of the tag |
color | string | Hex color code for the tag |
usage_count | integer | Number of times this tag has been applied |
created_at | ISO 8601 | When the tag was created |
ℹ️
Tags are returned as a flat array inside data with no pagination object. The full set is always returned in a single response.