Skip to main content
List branch-like bookmark refs using cursor pagination. Required scope: read
const bookmarks = await mesa.bookmarks.list({ repo: 'app', limit: 50 });

for (const bookmark of bookmarks.bookmarks) {
  console.log(bookmark.name, bookmark.change_id);
}

Options

repo
string
required
Repository name.
org
string | undefined
Organization override.
cursor
string | undefined
Opaque pagination cursor from a previous response.
limit
number | undefined
Maximum number of bookmarks to return. The server maximum is 100.

Response

next_cursor
string | null
Cursor for the next page, or null when no more results remain.
has_more
boolean
Whether another page of results is available.
bookmarks
Bookmark[]
Bookmark objects.

Bookmark

name
string
Bookmark name.
change_id
string
Change ID the bookmark points to.
is_default
boolean
Whether this is the repository default bookmark.