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.

Retrieve a structured diff between two Mesa change IDs. 
diff = await mesa.diffs.get(
    repo="app",
    base_change_id="zyxwvutsrqponmlkzyxwvutsrqponmlk",
    head_change_id="lmnopqrstuvwzyxklmnopqrstuvwzyxk",
)

print(diff.stats.additions, diff.stats.deletions)
Fetch only conflicted entries: 
diff = await mesa.diffs.get(
    repo="app",
    base_change_id="zyxwvutsrqponmlkzyxwvutsrqponmlk",
    head_change_id="lmnopqrstuvwzyxklmnopqrstuvwzyxk",
    conflicts="only",
)

​
Options

​
repo
str
required
Repository name.
​
base_change_id
str
required
Base Mesa change ID.
​
head_change_id
str
required
Head Mesa change ID.
​
conflicts
'include' | 'only' | 'exclude' | None
Controls whether conflicted entries are included, excluded, or returned exclusively.
​
org
str | None
Organization override.

​
Response

​
base_change_id
str
Base change ID.
​
head_change_id
str
Head change ID.
​
stats
object
Counts for entries, additions, deletions, changes, conflicted entries, and conflicted hunks.
​
truncated
bool
Whether the response hit the server entry limit and is incomplete.
​
entries
list
Non-conflicted changed entries with status, old path, size, omitted reason, and structured hunks when available.
​
conflicted_entries
list
Conflict-only entries with hunk IDs and per-side target/base/source content when available.

​
Required scope

read