Agents

Clone an AI Agent (v2)

Creates a copy owned by the caller, with a fresh address. The copy takes the source's configuration (prompt, model, response settings, categories, Memory, heartbeat, flows) and always starts private. This is how tenants customise a platform-owned agent such as the Support Agent template.

Any agent that is not private can be cloned; a private one only by its owner. Supports User JWT and B2B Server JWT. Requires the account's agents capability.

With includeKnowledge: true the source's knowledge (Web Index and Docs Index rows carrying the source's id, and their embeddings) is copied into the clone's home App under the clone's id. The clone is created either way; knowledge says what was copied.

post/v2/agents/{idOrAddress}/clone

Request

  • Base URL: https://api.chat.ethora.com
  • URL: https://api.chat.ethora.com/v2/agents/{idOrAddress}/clone
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

idOrAddressstring required

Agent id, or the agent's 0x... address.

Request body

displayNamestring

Name of the copy. Default is the source's name plus " (copy)".

ownerAppIdstring

Home App of the copy. Must be an App the caller manages. Default is the caller's App.

includeKnowledgeboolean

Also copy the source's web/doc knowledge and embeddings.

Response 

{
  ok: true,
  agent: Agent,
  // only when includeKnowledge was true:
  knowledge?: { copied: true, sites: number, docs: number, chunks: number|null }
            | { copied: false, reason: string }
}

Changes

No recorded changes to this operation across all 1 revision of this API.