---
title: "Create A New Branch"
method: POST
path: "/v1/convai/agents/{agent_id}/branches"
tags: ["Agents Platform"]
---

# Create A New Branch

`POST /v1/convai/agents/{agent_id}/branches`

Create a new branch from a given version of any branch

## 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

- BodyCreateANewBranchV1ConvaiAgentsAgentIdBranchesPost
  - `parent_version_id` string, required — ID of the version to branch from
  - `name` string, required — Name of the branch. It is unique within the agent.
  - `description` string, required — Description for the branch
  - `conversation_config` object, nullable — Changes to apply to conversation config
  - `platform_settings` object, nullable — Changes to apply to platform settings
  - `workflow` AgentWorkflowRequestModel
    - `edges` object
    - `nodes` object
    - `prevent_subagent_loops` boolean — Whether to prevent loops in the workflow execution.
  - `include_draft` boolean — When true, the new branch uses the caller's draft procedure set instead of the branch tip. Requires parent_version_id to be the branch tip.

## Response `200`

Successful Response

- CreateAgentBranchResponseModel
  - `created_branch_id` string, required — ID of the created branch
  - `created_version_id` string, required — ID of the first version on the created branch

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-26** `4a6716242c9e` — 3 info
  - added the new `deepseek-v41-flash` enum value to the request property `workflow/anyOf[subschema #1: AgentWorkflowRequestModel]/nodes/additionalProperties/oneOf[subschema #4: WorkflowOverrideAgentNodeModel]/conversation_config/agent/anyOf[subschema #1: AgentConfigAPIModelWorkflowOverride]/prompt/anyOf[subschema #1: PromptAgentAPIModelWorkflowOverride]/backup_llm_config/anyOf[subschema #3: BackupLLMOverride]/order/items/`
  - added the new `deepseek-v41-flash` enum value to the request property `workflow/anyOf[subschema #1: AgentWorkflowRequestModel]/nodes/additionalProperties/oneOf[subschema #4: WorkflowOverrideAgentNodeModel]/conversation_config/agent/anyOf[subschema #1: AgentConfigAPIModelWorkflowOverride]/prompt/anyOf[subschema #1: PromptAgentAPIModelWorkflowOverride]/llm/anyOf[subschema #1: LLM]/`
  - added the new `deepseek-v41-flash` enum value to the request property `workflow/anyOf[subschema #1: AgentWorkflowRequestModel]/nodes/additionalProperties/oneOf[subschema #4: WorkflowOverrideAgentNodeModel]/conversation_config/language_presets/anyOf[subschema #1]/additionalProperties/overrides/agent/anyOf[subschema #1: AgentConfigOverride]/prompt/anyOf[subschema #1: PromptAgentAPIModelOverride]/llm/anyOf[subschema #1: LLM]/`
- …earlier changes not shown

[Full history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/agents/:agent_id/branches/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/4a6716242c9e?raw)