Tags are labels applied to messages or sessions for categorization (for example, boardroom, qsys, commissioning, field-issue). Tags are a small dataset, so this endpoint returns all tags at once with no pagination.
code
GET /api/v1/apps/{appId}/tagsReturns all tags for the agent.
Example#
bash
curl "https://app.avcodex.com/api/v1/apps/YOUR_APP_ID/tags" \
-H "Authorization: Bearer avcodex_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. |
Note: Tags are returned as a flat array inside data with no pagination object. The full set is always returned in a single response.
*AVCodex · Your AV expertise. Amplified by AI.*