# Tags

Retrieve message tags from your Chipp app

---

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

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

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

> **Note:** Tags are returned as a flat array inside `data` with no pagination object. The full set is always returned in a single response.