Bulk Operations

Bulk endpoints let you act on up to 50 bookmarks in a single request.

Bulk Trash

POST /bookmarks/bulk/trash

Scope: bookmarks:write

Move multiple bookmarks to trash.

Body:

{
  "ids": ["bk_abc", "bk_def", "bk_ghi"]
}

Bulk Favorite

POST /bookmarks/bulk/favorite

Scope: bookmarks:write

Set or unset favorite on multiple bookmarks.

Body:

{
  "ids": ["bk_abc", "bk_def"],
  "isFavorite": true
}

Bulk Move

POST /bookmarks/bulk/move

Scope: bookmarks:write

Move multiple bookmarks to a collection.

Body:

{
  "ids": ["bk_abc", "bk_def"],
  "collectionId": "col_xyz"
}

Pass null for collectionId to move to Unsorted.

Bulk Tag

POST /bookmarks/bulk/tag

Scope: tags:write

Add a tag to multiple bookmarks.

Body:

{
  "ids": ["bk_abc", "bk_def"],
  "name": "important"
}

Bulk Untag

DELETE /bookmarks/bulk/tag

Scope: tags:write

Remove a tag from multiple bookmarks.

Body:

{
  "ids": ["bk_abc", "bk_def"],
  "tagId": "tag_xyz"
}

Empty Trash

DELETE /bookmarks/trash

Scope: destructive

Permanently deletes all trashed bookmarks. This cannot be undone.

This is a heavy endpoint with a rate limit of 1 request per minute.