Get a temporary signed URL for downloading an asset by its asset ID.

Search for bookmarks matching a specific query using full-text, semantic, or hybrid search.

Get a bookmark by id.

List every list that contains a bookmark.

Create a link bookmark or a text bookmark

Update fields on an existing bookmark. Only the fields you pass are modified; omitted fields stay unchanged. Returns the updated bookmark.

Get the content of the bookmark in markdown

Delete a bookmark by id. This is destructive — the bookmark, its highlights, and its assets are removed.

List highlights across all bookmarks, newest first.

List every highlight on a bookmark.

Retrieve a single highlight by id.

Create a text highlight on a bookmark using character offsets from the bookmark's readable content.

Update a highlight's color or note.

Delete a highlight by id.

Retrieves a list of lists.

Retrieve a single list by its id.

Update a list. Only the fields you pass are changed. Length caps and smart-list query rules come from the shared list schema.

Delete a list by id. Bookmarks inside the list are not deleted. Child lists are also not deleted. Any child lists become root-level lists (their parentId is set to null). If that isn't the tree change you want, move or re-parent the children before calling this.

Add a bookmark to a list.

Remove a bookmark from a list.

List bookmarks in a list by its stable id. Smart lists are evaluated using their saved query.

Create a list.

Attach a tag to a bookmark.

Detach a tag from a bookmark.

List tags with their bookmark counts. Supports filtering and pagination.

Retrieve a single tag by id, including its bookmark counts.

Rename a tag. The new name is normalized by the server.

Delete a tag by id. Bookmarks that had this tag are not deleted; the tag is just removed from them.

List bookmarks that have a given tag, with pagination.