# Tags

Retrieve message tags from your AVCodex agent.

---

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

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

Returns 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.*