Create A Merge Proposal

Record a request to merge a source branch into a target branch. Anyone with edit access can open one; merging it later is gated on write access to the target branch, so this is how a change reaches a protected branch the author cannot merge into themselves.

Path parameters

agent_idstringRequired
The id of an agent. This is returned on agent creation.

Headers

xi-api-keystringOptional

Request

This endpoint expects an object.
source_branch_idstringRequired
Branch whose changes should be merged.
target_branch_idstringRequired
Branch that should receive the changes.
titlestringRequired1-140 characters

Short title for the merge_proposal.

descriptionstringOptional<=4096 charactersDefaults to
Optional longer description for reviewers.
requested_reviewer_user_idslist of strings or nullOptional
User IDs to request a review from.
triage_ticket_idstring or nullOptional

Triage ticket of this agent that the merge_proposal resolves. Merging it resolves the ticket if still open.

Response

Successful Response
created_merge_proposal_idstring

ID of the created merge_proposal

Errors

422
Unprocessable Entity Error