GET/api/v1/tags

List tags

Returns all tags in your workspace, ordered by creation date (newest first). Each tag includes a count of how many links are using it.

Authorization

Authorizationstringheaderrequired

Bearer token. Format: Bearer YOUR_API_KEY

curl https://app.brevr.io/api/v1/tags \
-H "Authorization: Bearer YOUR_API_KEY"

{
"tags": [
  {
    "id": "tag_abc123",
    "name": "summer-campaign",
    "color": "#3b82f6",
    "createdAt": "2024-06-01T10:00:00.000Z",
    "_count": { "links": 42 }
  },
  {
    "id": "tag_def456",
    "name": "paid",
    "color": "#ef4444",
    "createdAt": "2024-05-15T08:00:00.000Z",
    "_count": { "links": 18 }
  }
]
}