---
title: "Create Agent Draft"
method: POST
path: "/v1/convai/agents/{agent_id}/drafts"
tags: ["Agents Platform"]
---

# Create Agent Draft

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

Create a new draft for an agent

## Path parameters

- `agent_id` string, required — The id of an agent. This is returned on agent creation.

## Query parameters

- `branch_id` string, required — The ID of the agent branch to use

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

- BodyCreateAgentDraftV1ConvaiAgentsAgentIdDraftsPost
  - `conversation_config` object, required — Conversation config for the draft
  - `platform_settings` object, required — Platform settings for the draft
  - `workflow` AgentWorkflowRequestModel, required
    - `edges` object
    - `nodes` object
    - `prevent_subagent_loops` boolean — Whether to prevent loops in the workflow execution.
  - `name` string, required — Name for the draft
  - `tags` string[], nullable — Tags to help classify and filter the agent

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-04** `d393c67c384a` — 9 breaking, 29 info
  - removed `#/components/schemas/QueryParamsJsonSchema` from the `workflow/nodes/additionalProperties/oneOf[subschema #4: WorkflowOverrideAgentNodeModel]/conversation_config/agent/anyOf[subschema #1: AgentConfigAPIModelWorkflowOverride]/prompt/anyOf[subschema #1: PromptAgentAPIModelWorkflowOverride]/tools/anyOf[subschema #1]/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/query_params_schema` request property `anyOf` list
  - removed `#/components/schemas/RunSubagentToolConfig-Input` from the `workflow/nodes/additionalProperties/oneOf[subschema #4: WorkflowOverrideAgentNodeModel]/conversation_config/agent/anyOf[subschema #1: AgentConfigAPIModelWorkflowOverride]/prompt/anyOf[subschema #1: PromptAgentAPIModelWorkflowOverride]/built_in_tools/anyOf[subschema #1: BuiltInToolsWorkflowOverride]/end_call/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/RunSubagentToolConfig-Input` from the `workflow/nodes/additionalProperties/oneOf[subschema #4: WorkflowOverrideAgentNodeModel]/conversation_config/agent/anyOf[subschema #1: AgentConfigAPIModelWorkflowOverride]/prompt/anyOf[subschema #1: PromptAgentAPIModelWorkflowOverride]/built_in_tools/anyOf[subschema #1: BuiltInToolsWorkflowOverride]/language_detection/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/RunSubagentToolConfig-Input` from the `workflow/nodes/additionalProperties/oneOf[subschema #4: WorkflowOverrideAgentNodeModel]/conversation_config/agent/anyOf[subschema #1: AgentConfigAPIModelWorkflowOverride]/prompt/anyOf[subschema #1: PromptAgentAPIModelWorkflowOverride]/built_in_tools/anyOf[subschema #1: BuiltInToolsWorkflowOverride]/play_keypad_touch_tone/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - …34 more
- …earlier changes not shown

[Full history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/agents/:agent_id/drafts/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-service-production.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/d393c67c384a/schema)