Skip to main content
List current reachable changes, optionally restricted to a bookmark. Required scope: write
changes = await mesa.changes.list(repo="app", bookmark="main")

for change in changes.changes:
    print(change.id, change.current_commit_oid, change.message)

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 changes to return. The server maximum is 100.
bookmark
str | None
Restrict results to changes reachable from this bookmark.

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.
changes
list[Change]
Change objects.

Change

id
str
Change ID.
current_commit_oid
str
Current commit OID for the change.
is_conflicted
bool
Whether the current commit still contains unresolved conflicts.
message
str
Current change description. Empty string means the change has no description.
author
CommitIdentity
Commit author identity.
committer
CommitIdentity
Committer identity.
parents
list[str]
Parent change IDs for this change.
created_at
datetime
Creation time.
updated_at
datetime
Last update time.

CommitIdentity

name
str
Author or committer display name.
email
str
Author or committer email address.
date
datetime | None
Timestamp for this identity when provided.