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.

Merge source into target. The target bookmark advances to the merge result. 
result = await mesa.bookmarks.merge(
    repo="app",
    source="feature-x",
    target="main",
    delete_source=True,
)
print(result.merge_type, result.change_id)
Resolve conflicts on retry: 
from mesa_sdk import WholeFileResolution

result = await mesa.bookmarks.merge(
    repo="app",
    source="feature-x",
    target="main",
    resolutions=[WholeFileResolution(path="README.md", take="source")],
)

​
Options

​
repo
str
required
Repository name.
​
source
str
required
Source bookmark with changes to merge.
​
target
str
required
Target bookmark to advance.
​
delete_source
bool | None
Delete the source bookmark after a successful merge.
​
allow_conflicted
bool | None
When True, accept a merge that still contains textual conflicts. When omitted or False, conflicted merges fail with ConflictError.
​
resolutions
list[Resolution] | None
Whole-file or per-hunk conflict resolutions applied before conflict detection.
​
org
str | None
Organization override.

​
Response

​
merge_type
'merge_commit' | 'no_op'
Merge outcome. Divergent merges create explicit merge commits.
​
is_conflicted
bool
Whether the resulting merge commit still contains unresolved conflicts.
​
commit_oid
str
Git commit OID the target bookmark now points to.
​
change_id
str
Mesa change ID the target bookmark now points to.
​
target
str
Target bookmark name.
​
source
str
Source bookmark name.
​
source_deleted
bool
Whether the source bookmark was deleted.

​
Required scope

write