Tags

Tags let you organize links into groups. Each tag has a name and a color. Links can have multiple tags attached.

POST /api/v1/tags — Create a new tag in your workspace.

GET /api/v1/tags — Retrieve all tags in your workspace.

GET /api/v1/tags/:id — Fetch a single tag by ID.

DELETE /api/v1/tags/:id — Permanently remove a tag.

The Tag Object


{
  "id": "tag_abc123",
  "name": "summer",
  "color": "#3b82f6",
  "createdAt": "2024-06-01T10:00:00.000Z",
  "_count": {
    "links": 42
  }
}

Field	Type	Description
`id`	string	Unique identifier for the tag
`name`	string	Tag label (letters, numbers, spaces, hyphens, underscores)
`color`	string	Hex color code, e.g. `#3b82f6`
`createdAt`	string	ISO 8601 timestamp
`_count.links`	number	Number of links currently using this tag