Skip to main content
Bookmarks are named refs analogous to Git branches. Required scope: read
bookmarks = await mesa.bookmarks.list(repo="app")

for bookmark in bookmarks.bookmarks:
    print(bookmark.name, bookmark.change_id, bookmark.is_default)

Options

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

Response

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

Bookmark

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