Clone an Agent
POST
/api/v2/agents/{agent_id}/clone
corpus links, tools, guardrails and other settings. Use it to start a new agent from
one that already works. You become the owner of the copy, whoever owns the source.
copy's project can use the copy. Where staging versions are in use, the copy gets its
own staging version.
Request
Path Params
Header Params
Body Params
application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --globoff 'https:///api/v2/agents//clone' \
--header 'X-Authorization-Consistency-Token;' \
--header 'Organization-Id;' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"name": "Support Assistant (EU)",
"project_id": 15,
"access": "Only me",
"status": "Drafted"
}'Response Response Example
201 - Copied agent
{
"success": true,
"message": "Agent cloned successfully.",
"data": {
"id": 57,
"created_by": "[email protected]",
"modified_by": "[email protected]",
"created_on": "2026-09-14T10:21:07.512Z",
"modified_on": "2026-10-02T16:45:31.004Z",
"user": {
"id": 7,
"email": "[email protected]",
"first_name": "Sam",
"last_name": "Lee",
"organization": 3
},
"agent_type": {
"id": 1,
"created_by": null,
"modified_by": null,
"created_on": "2025-01-10T09:00:00Z",
"modified_on": "2025-01-10T09:00:00Z",
"name": "QnA",
"description": "Answers questions from its knowledge base.",
"parent": null
},
"instructions": [
{
"id": 311,
"created_by": "[email protected]",
"modified_by": "[email protected]",
"created_on": "2026-09-14T10:21:08.100Z",
"modified_on": "2026-09-14T10:21:08.100Z",
"instruction": "Answer in English.",
"is_deleted": false,
"parent": null,
"agent": 42
}
],
"project": {
"id": 12,
"project_name": "Customer Support"
},
"connected_tool_names": [
"RAG Tool",
"Attachment Tool"
],
"tags": [
"support"
],
"character_voice": {
"id": 5,
"voice_name": "Alloy",
"voice_identifier": "alloy",
"gender": "female"
},
"pattern": {
"id": 1,
"name": "ReAct",
"description": "Reason and act with tools."
},
"staging_agent_id": 58,
"agent_name": "Support Assistant - Copy",
"industry_area": "",
"domain": "Answers customer questions about orders and returns.",
"sample_q1": "Where is my order?",
"sample_q2": "How do I return an item?",
"sample_q3": null,
"sample_q4": null,
"prefix_prompt": "You are a friendly support assistant for an online shop.",
"alias": null,
"is_active": false,
"is_deleted": false,
"agent_image": null,
"access": "Only me",
"status": "Drafted",
"caching_enabled": false,
"chunk_count": 32,
"attachment_chunk_count": 10,
"attachment_chunking": false,
"react_enabled": true,
"react_max_iteration_count": 50,
"reasoning_mode": "react",
"call_enabled": false,
"is_published_as_teammate": false,
"chat_count": 0,
"likes_count": 0,
"conversation_starter_enabled": false,
"enable_embed": false,
"langfuse_tracing_enabled": true,
"parent": null,
"llm_config": 9,
"cloned_from": null,
"voice_llm_config": 11
}
}