Skip to main content
List changes in a repository using cursor pagination. Required scope: write 
const changes = await mesa.changes.list({ repo: 'app', bookmark: 'main' });

for (const change of changes.changes) {
  console.log(change.id, change.message);
}

​
Options

​
repo
string
required
Repository name.
​
org
string | undefined
Organization override.
​
bookmark
string | undefined
Bookmark whose reachable changes should be listed. Defaults to the repository default bookmark.
​
cursor
string | undefined
Opaque pagination cursor from a previous response.
​
limit
number | undefined
Maximum number of changes 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.
​
changes
Change[]
Change objects.

​
Change

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

​
CommitIdentity

​
name
string
Author or committer display name.
​
email
string
Author or committer email address.
​
date
string | undefined
Timestamp for this identity when provided.