Get Agent

Retrieve a specific agent by ID.

GET/v2/agents/{public_id}

Get a single agent with full unified configuration.

Path Parameters

The agent's public ID (format: ag_*)

Response

Returns the full agent object with nested configuration sections. Voice-related fields (transcriber, voice, interruptionConfig, etc.) are only populated when voiceEnabled is true.

{
  "id": "ag_c47e7c97_b2f2",
  "name": "Sales Agent",
  "createdAt": "2026-03-07T10:00:00Z",
  "updatedAt": null,

  "model": {
    "provider": "openai",
    "model": "gpt-4o",
    "temperature": null,
    "maxTokens": null,
    "instructions": "You are a helpful sales assistant."
  },

  "transcriber": null,
  "voice": null,

  "tools": [
    { "name": "duckduckgo", "type": "duckduckgo", "enabled": true },
    { "name": "email", "type": "email", "enabled": true }
  ],

  "knowledgeBase": {
    "sources": [
      { "id": "42", "name": "Product FAQ", "type": "text", "status": "ready" }
    ]
  },

  "voiceEnabled": false,
  "agentType": "simple",

  "firstMessage": null,
  "endCallEnabled": true,

  "interruptionConfig": null,
  "recordingConfig": null,
  "dtmfConfig": null,
  "silenceConfig": null,
  "multilingualConfig": null,
  "callSummaryConfig": null,
  "webhookConfig": null,

  "maxDurationSeconds": 0,
  "noiseCancellation": "none",

  "publishConfig": null,
  "graphData": null
}

Voice-Enabled Agent Response

When voiceEnabled is true, voice configuration sections are populated:

{
  "id": "ag_d58f8d08_c3g3",
  "name": "Phone Support Agent",
  "voiceEnabled": true,

  "model": {
    "provider": "openai",
    "model": "gpt-4o",
    "temperature": null,
    "maxTokens": null,
    "instructions": "You are a phone support agent."
  },

  "transcriber": {
    "provider": "deepgram",
    "model": "nova-2-conversationalai",
    "language": "en"
  },

  "voice": {
    "provider": "deepgram",
    "model": null,
    "voiceId": "aero-vayu",
    "speed": 1.0
  },

  "firstMessage": "Hello! How can I help you today?",
  "endCallEnabled": true,

  "interruptionConfig": {
    "enabled": true,
    "threshold": 0.5,
    "minSilenceDuration": 0.3,
    "minSpeechDuration": 0.1
  },

  "recordingConfig": {
    "enabled": false,
    "downloadEnabled": true
  },

  "dtmfConfig": {
    "enabled": false,
    "ivrDetection": false,
    "menuEnabled": false
  },

  "silenceConfig": {
    "unresponsiveTimeoutSeconds": 30,
    "unresponsiveFinalSeconds": 15,
    "fillersEnabled": false,
    "fillerPhrases": []
  },

  "multilingualConfig": {
    "enabled": false,
    "primaryLanguage": "en"
  },

  "callSummaryConfig": {
    "enabled": false,
    "prompt": ""
  },

  "webhookConfig": {
    "url": "",
    "events": [],
    "retryCount": 3
  },

  "maxDurationSeconds": 600,
  "noiseCancellation": "none"
}

Response Fields

SectionFieldTypeDescription
CoreidstringPublic agent ID (ag_*)
namestringAgent display name
createdAtstringISO 8601 creation timestamp
agentTypestringsimple, graph, or workflow
voiceEnabledbooleanWhether voice/phone calls are enabled
Modelmodel.providerstringLLM provider (openai, anthropic, google, etc.)
model.modelstringModel name (gpt-4o, claude-3-5-sonnet-20241022, etc.)
model.temperaturefloat | nullLLM temperature setting
model.maxTokensint | nullMaximum response tokens
model.instructionsstringSystem prompt
Transcribertranscriber.providerstringSTT provider (deepgram, openai, sarvam)
transcriber.modelstringSTT model ID
transcriber.languagestringLanguage code
Voicevoice.providerstringTTS provider (deepgram, aero, elevenlabs)
voice.voiceIdstringVoice identifier
voice.speedfloatPlayback speed multiplier
Toolstools[].namestringTool display name
tools[].typestringTool type identifier
tools[].enabledbooleanWhether tool is active
KnowledgeknowledgeBase.sources[]arrayAttached knowledge sources
GraphgraphDataobject | nullWorkflow graph (only for graph/workflow agents)

Errors

CodeDescription
404Agent not found
403Not authorized to access this agent

On this page