Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mesa.dev/llms.txt

Use this file to discover all available pages before exploring further.

List branch-like bookmark refs using cursor pagination. 
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 is available.
​
bookmarks
array
Bookmark objects with name, change_id, and is_default.

​
Required scope

read