changes.list() - Mesa Docs

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

string

required

Repository name.

string | undefined

Bookmark whose reachable changes should be listed. Defaults to the repository default bookmark.

string | undefined

Opaque pagination cursor from a previous response.

number | undefined

Maximum number of changes to return. The server maximum is 100.

Response

string | null

Cursor for the next page, or null when no more results remain.

boolean

Whether another page of results is available.

Change[]

Change objects.

Change

string

Change ID.

string

Current commit OID for the change.

boolean

Whether the current commit still contains unresolved conflicts.

string

Current change description. Empty string means the change has no description.

CommitIdentity[]

Complete ordered commit attribution. Every entry is an equal contributor.

string

Shared ISO 8601 authored timestamp. The virtual root uses the Unix epoch.

CommitSignature

Committer identity. The virtual root has an empty name and email at the Unix epoch.

The deprecated REST author field is not returned by the SDK; read authors and authored_at.

string[]

Parent change IDs for this change.

string

Creation time.

string

Last update time.

CommitIdentity

string

Author display name.

string | null

Author email address, or null when no email was supplied.

CommitSignature

string

Committer display name.

string

Email address, or "" when none was supplied. This string form is retained for compatibility.

string | undefined

Timestamp for this signature when provided.

​Options

​Response

​Change

​CommitIdentity

​CommitSignature

Options

Response

Change

CommitIdentity

CommitSignature