Skip to main content
GET
/
ext
/
agent
/
{id}
Retrieve an Agent by ID
curl --request GET \
  --url https://api.trugen.ai/v1/ext/agent/{id} \
  --header 'x-api-key: <api-key>'
{
  "id": "b63c2a53-266b-4b43-a71b-7ea8b5e2e916",
  "agent_name": "Customer Support Agent",
  "agent_system_prompt": "You are a helpful AI assistant that handles customer service inquiries.",
  "avatars": [
    {
      "avatar_key_id": "1e4ea106",
      "persona_name": "Sofia - Friendly Support",
      "persona_prompt": "Speak in a warm, engaging tone and provide clear answers.",
      "config": {
        "llm": {
          "model": "meta-llama/llama-4-maverick-17b-128e-instruct",
          "provider": "groq"
        },
        "stt": {
          "model": "flux-general-en",
          "provider": "deepgram",
          "min_endpointing_delay": 0.3,
          "max_endpointing_delay": 0.4
        },
        "tts": {
          "model_id": "eleven_turbo_v2_5",
          "provider": "elevenlabs",
          "voice_id": "ZUrEGyu8GFMwnHbvLhv2"
        }
      }
    }
  ],
  "callback_events": [
    "participant_left",
    "agent.started_speaking",
    "agent.stopped_speaking",
    "agent.interrupted",
    "user.started_speaking",
    "user.stopped_speaking",
    "utterance_committed",
    "max_call_duration_timeout"
  ],
  "callback_url": "https://webhooks.example.com/agent-events",
  "config": {
    "systemPrompt": "Always respond with a concise solution first, then provide optional detail.",
    "maxCallDuration": 1800,
    "conversationalContext": "customer-support"
  },
  "knowledge_base": [
    {
      "id": "ac79226e-73e1-41fe-8cde-469ae4e244fa",
      "name": "Product Support Articles",
      "description": "Contains FAQs and troubleshooting guides for product lines."
    }
  ],
  "tool": [
    {
      "id": "ac79226e-73e1-41fe-8cde-469ae4e244fa",
      "name": "Product Support Articles",
      "description": "Tool for accessing employee directory."
    }
  ],
  "mcp": [
    {
      "id": "ac79226e-73e1-41fe-8cde-469ae4e244fa",
      "name": "Product Support Articles",
      "description": "MCP for accessing employee directory."
    }
  ],
  "record": true,
  "created_at": "2025-12-01T10:20:30.000Z",
  "updated_at": "2025-12-03T14:50:00.000Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.trugen.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
id
string<uuid>
required

Unique identifier for the Agent

Response

Agent retrieved successfully

​
id
string<uuid>

Unique identifier for the agent.

Example:

"b63c2a53-266b-4b43-a71b-7ea8b5e2e916"

​
agent_name
string

Display name of the agent.

Example:

"Customer Support Agent"

​
agent_system_prompt
string

Foundational system instruction used by this agent.

Example:

"You are a helpful AI assistant that handles customer service inquiries."

​
avatars
object[]

List of avatars associated with this agent.

​
callback_events
string[]

Webhook events that should trigger callbacks.

Example:
[
  "participant_left",
  "agent.started_speaking",
  "agent.stopped_speaking",
  "agent.interrupted",
  "user.started_speaking",
  "user.stopped_speaking",
  "utterance_committed",
  "max_call_duration_timeout"
]
​
callback_url
string

Webhook endpoint URL to send callback events to.

Example:

"https://webhooks.example.com/agent-events"

​
config
object

Agent-level configuration properties.

​
knowledge_base
object[] | null

List of knowledge bases attached to this agent.

​
tool
object[] | null

List of tools attached to this agent.

​
mcp
object[] | null

List of MCP attached to this agent.

​
record
boolean

Determines whether voice call recordings should be stored.

Example:

true

​
created_at
string<date-time>

Timestamp indicating when the agent was created.

Example:

"2025-12-01T10:20:30.000Z"

​
updated_at
string<date-time>

Last updated timestamp for the agent.

Example:

"2025-12-03T14:50:00.000Z"