> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threetone.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Merge proposals

> Review a branch merge preview and prepare an approval record without assuming a proposal-management workflow.

A merge review should explain what changes, which branch receives the change, and what evidence supports it. The API provides branch previews and merge operations for this review.

<Note>
  Proposal creation, reviewer approvals, and proposal comments are planned. The dashboard merge-review action is not connected. Use the public preview API and keep the human review record in your own review process.
</Note>

You need access to the agent and distinct source and target branches. The supported merge direction is a non-main source branch into main.

<Steps>
  <Step title="Identify the proposed change" id="merge-identify-change">
    Record the source and main branch IDs, current version IDs, reason for the change, and any [triage ticket](/agents-platform/monitor/triage).
  </Step>

  <Step title="Inspect the merge preview" id="merge-inspect-preview">
    Request [Preview merged configuration](/api-reference/agents-platform/preview-merged-configuration) with `target_branch_id`. Read the combined configuration and conflict information. The `force` option changes conflict selection; it is not reviewer approval.
  </Step>

  <Step title="Review publication readiness" id="merge-review-readiness">
    Refresh the preview if either branch changes. An authorized [merge](/api-reference/agents-platform/merge-agent-branch) must pass publication validation. Managed-model text-only configurations can be eligible; voice and custom-model configurations are blocked.
  </Step>
</Steps>

Publication and deployment are separate. A merged configuration does not demonstrate successful runtime execution. Keep unresolved conflicts and unexecuted tests visible in the review record.

<AccordionGroup>
  <Accordion title="Does a preview modify a branch?" id="merge-faq-preview">No. Previewing and merging are separate operations. Review the exact inputs again before a merge.</Accordion>
  <Accordion title="Can I require an approval inside Threetone?" id="merge-faq-approval">There is no released proposal approval resource or connected approval workflow for branch merges.</Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.