Create Agent Draft
Changed onCreate a new draft for an agent
Request
- Base URLhttps://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
- URLhttps://api.elevenlabs.io/v1/convai/agents/{agent_id}/drafts
- Authnone declared
Path parameters
The id of an agent. This is returned on agent creation.
Query parameters
The ID of the agent branch to use
Headers
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
Example request
{
"workflow": {
"edges": {
"entry_to_tool_a": {
"forward_condition": {
"condition": "Tool A condition"
},
"source": "entry_node",
"target": "tool_node_a"
},
"start_to_entry": {
"forward_condition": {},
"source": "start_node",
"target": "entry_node"
},
"tool_a_to_failure": {
"forward_condition": {
"successful": false
},
"source": "tool_node_a",
"target": "failure_node"
},
"tool_a_to_tool_b": {
"forward_condition": {
"successful": true
},
"source": "tool_node_a",
"target": "tool_node_b"
},
"tool_b_to_agent_transfer": {
"forward_condition": {},
"source": "tool_node_b",
"target": "success_transfer"
},
"tool_b_to_conversation": {
"forward_condition": {
"condition": "Conversation condition"
},
"source": "tool_node_b",
"target": "success_conversation"
},
"tool_b_to_end": {
"forward_condition": {
"condition": "End condition"
},
"source": "tool_node_b",
"target": "success_end"
},
"tool_b_to_phone": {
"forward_condition": {
"expression": {
"children": [
{
"name": "force_phone_transfer"
},
{
"prompt": "Phone condition",
"value_schema": {
"description": "Phone condition",
"type": "boolean"
}
},
{
"left": {
"name": "mode"
},
"right": {
"value": "dev"
}
}
]
}
},
"source": "tool_node_b",
"target": "success_phone"
}
},
"nodes": {
"entry_node": {
"conversation_config": {},
"edge_order": [
"entry_to_tool_a"
],
"label": "Entry"
},
"failure_node": {
"conversation_config": {},
"label": "Failure"
},
"start_node": {
"edge_order": [
"start_to_entry"
]
},
"success_conversation": {
"conversation_config": {},
"label": "Success A"
},
"success_end": {},
"success_phone": {
"transfer_destination": {
"phone_number": "+1234567890"
}
},
"success_transfer": {
"agent_id": "success_transfer_agent"
},
"tool_node_a": {
"edge_order": [
"tool_a_to_failure",
"tool_a_to_tool_b"
],
"tools": [
{
"tool_id": "tool_a"
},
{
"tool_id": "tool_b"
}
]
},
"tool_node_b": {
"edge_order": [
"tool_b_to_conversation",
"tool_b_to_end",
"tool_b_to_phone",
"tool_b_to_agent_transfer"
],
"tools": [
{
"tool_id": "tool_a"
}
]
}
}
},
"tags": [
"Customer Support",
"Technical Help",
"Eleven"
]
}Response
Successful Response
Changes
- warning
removed the request property
/////////////// - warning
removed the request property
/////////////// - info
added the new optional request property
/////////////// - info
added the new optional request property
/////////////// - info
added
owner_get_client_appointmentsowner_list_assetsowner_list_locationsowner_list_productsowner_list_servicesowner_list_staffdiscriminator mapping keys to the/////////////request property - info
added to the
/////////////request propertyoneOflist
- warning
- info
added the new optional request property
/////////
- info