---
title: "Create A Merge Proposal"
method: POST
path: "/v1/convai/agents/{agent_id}/merge-proposals"
tags: ["Agents Platform"]
---

# Create A Merge Proposal

`POST /v1/convai/agents/{agent_id}/merge-proposals`

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_id` string, required — The id of an agent. This is returned on agent creation.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- BodyCreateAMergeProposalV1ConvaiAgentsAgentIdMergeProposalsPost
  - `source_branch_id` string, required — Branch whose changes should be merged.
  - `target_branch_id` string, required — Branch that should receive the changes.
  - `title` string, required — Short title for the merge_proposal.
  - `description` string — Optional longer description for reviewers.
  - `requested_reviewer_user_ids` string[], nullable — User IDs to request a review from.
  - `triage_ticket_id` string, nullable — Triage ticket of this agent that the merge_proposal resolves. Merging it resolves the ticket if still open.

## Response `200`

Successful Response

- CreateAgentMergeProposalResponseModel
  - `created_merge_proposal_id` string, required — ID of the created merge_proposal

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-30** `b3fe16f8d37a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/agents/:agent_id/merge-proposals/post.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/b3fe16f8d37a?raw)