Skip to main content
POST
Import Agent Template

Import from Template

Server-side scrub (Phase 0)

Import never shallow-copies a full live agent doc. The API allowlists structural fields only (theme, scrubbed voiceConfig, enableNodes, vg_defaultModel, nodes/instructions, UI toggles). Never inherited:
  • branding (forced to "")
  • funnelConfig / notification recipients
  • roundedImageURL from the source
  • Channel tokens, webhooks, marketplace, usage counters, SECRET_API_KEY, foreign ownerID
Prefer POST /agent-templates/{templateId}/create for system templates, or POST /agents/{agentId}/clone for cloning a live agent with explicit carryOver.

Convert Existing Agent to Node-Based

Use fromAgentId to convert a legacy agent to the node-based architecture:
This will:
  • Create a new node-based agent from scrubbed source fields
  • Migrate vg_systemPrompt and vg_initPrompt to the start node’s instructions
  • Copy all tools and variables with new IDs
  • Migrate knowledge base documents

Example Response

Notes

  • New unique IDs are generated for the agent, tools, and variables
  • Tool and variable references in instructions are automatically updated
  • Agent limits are enforced based on your plan

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
agentTemplate
object
agentName
string
fromAgentId
string

Response

Successful response

agentCreated
object
required