Tags

Tags can be applied to bookmarks for flexible organization. Tags support hierarchy using / separators (e.g., dev/frontend).

List Tags

GET /tags

Scope: tags:read

{
  "data": [
    {
      "id": "tag_abc",
      "name": "development",
      "color": "blue",
      "count": 42
    },
    {
      "id": "tag_def",
      "name": "dev/frontend",
      "color": null,
      "count": 15
    }
  ]
}

Create Tag

POST /tags

Scope: tags:write

Body:

{
  "name": "new-tag",
  "color": "green"
}

Rename Tag

PATCH /tags/:id

Scope: tags:write

Body:

{
  "newName": "renamed-tag"
}

Renaming updates the tag across all bookmarks that use it.

Delete Tag

DELETE /tags/:id

Scope: tags:write

Removes the tag and all bookmark-tag associations. The bookmarks themselves are not affected.

Merge Tags

POST /tags/merge

Scope: tags:write

Merges one tag into another. All bookmarks with the source tag will be re-tagged with the target tag. The source tag is deleted.

Body:

{
  "sourceTagId": "tag_abc",
  "targetTagId": "tag_def"
}