Skip to main content
GET
/
ext
/
agents
Retrieve all Agents
curl --request GET \
  --url https://api.trugen.ai/v1/ext/agents \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "045302f0-9783-4ff2-846e-3888fb2a7894",
    "agent_name": "HR Assistant",
    "agent_system_prompt": "You are an HR Assistant.",
    "avatars": [
      {
        "avatar_key_id": "1e4ea106",
        "persona_name": "Lisa",
        "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": [
      "utterance_committed"
    ],
    "callback_url": "",
    "config": {
      "maxCallDuration": 10,
      "conversationalContext": "You are going to speak with employees from our Machine Learning Team."
    },
    "knowledge_base": null,
    "mcp": null,
    "tool": null,
    "record": true,
    "created_at": "2025-10-17T19:05:25.557061Z",
    "updated_at": "2025-10-17T19:05:25.557061Z"
  }
]

Authorizations

​
x-api-key
string
header
required

Response

List of agents 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"