---
title: "Tags — AVCodex Docs"
description: "Tags — AVCodex documentation for AV integrators, programmers, and ops teams."
lang: en
json-ld:
---

[](/)

Solutions

[Pricing](/pricing)[The Signal](/blog)[Resources](/resources)

Learn

[Free AI Assessment](/scorecard)[Get Started →](/pricing)

[Documentation Home](/docs)

Guides 

Custom Actions 

Pro Actions 

API 

Builder API 

-   [Overview](/docs/builder-api/overview)
-   [Sessions](/docs/builder-api/sessions)
-   [Consumers](/docs/builder-api/consumers)
-   [Feedback](/docs/builder-api/feedback)
-   [Tags](/docs/builder-api/tags)
-   [Knowledge Sources](/docs/builder-api/knowledge-sources)
-   [Memories](/docs/builder-api/memories)
-   [Analytics](/docs/builder-api/analytics)

Agentic Commerce (ACP) 

Integrations 

[Docs](/docs)/ Builder API / Builder API 

# Tags

Last updated · MAR 2026 · [Read as Markdown](/docs/builder-api/tags.md)

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.

## [List tags# ](#list-tags)

code 

```
GET /api/v1/apps/{appId}/tags
```

Returns all tags for the agent.

### [Example# ](#example)

bash 

```
curl "https://app.avcodex.com/api/v1/apps/YOUR_APP_ID/tags" \
  -H "Authorization: Bearer avcodex_YOUR_API_KEY"
```

### [Response# ](#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# ](#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.\*

Was this helpful? 

[Edit this page →](#)

[

Previous

Feedback

](/docs/builder-api/feedback)[

Next

Knowledge Sources

](/docs/builder-api/knowledge-sources)

On this page

-   [List tags](#list-tags)
-   [Example](#example)
-   [Response](#response)
-   [Response fields](#response-fields)

[](/)

The AI platform built exclusively for professional AV. Build, deploy, and sell AI tools that understand your industry.

### Platform

-   What You Can Build
-   Templates
-   [Pricing](/pricing)

### Services

-   [Done-For-You](/pricing)
-   [Academy](/academy)
-   [Contact](/contact)

### Company

-   About
-   [The Signal](/blog)
-   [Docs](/docs)
-   [LinkedIn](#)

© 2026 AVCodex. A Future Ready Holdings Inc. product. SOC 2 Type II Certified · HIPAA Compliant