Create Agent

Create an agent

curl --request POST \
  --url https://api.trugen.ai/v1/agent/api \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "avatar_ids": [
    "ava_ae61c9e28b",
    "ava_ed3a666dc5"
  ],
  "name": "New Agent",
  "system_prompt": "You are a helpful assistant",
  "email": "test@test.com",
  "config": {
    "timeout": 240
  },
  "is_active": true,
  "knowledge_base": [
    {
      "id": "4a0365e4-ced5-42f0-8933-b6880a0ce044",
      "name": "new kb 123"
    }
  ],
  "record": true,
  "callback_url": "https://play.svix.com/in/e_pBuXcpDaVzRzwn3L5El4xFFlKnD/",
  "callback_events": [
    "participant_left",
    "max_call_duration_warning",
    "max_call_duration_timeout",
    "action_found"
  ]
}
'

{
  "id": "045302f0-9783-4ff2-846e-3888fb2a7894",
  "message": "Agent created successfully"
}

POST

agent

api

Create an agent

curl --request POST \
  --url https://api.trugen.ai/v1/agent/api \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "avatar_ids": [
    "ava_ae61c9e28b",
    "ava_ed3a666dc5"
  ],
  "name": "New Agent",
  "system_prompt": "You are a helpful assistant",
  "email": "test@test.com",
  "config": {
    "timeout": 240
  },
  "is_active": true,
  "knowledge_base": [
    {
      "id": "4a0365e4-ced5-42f0-8933-b6880a0ce044",
      "name": "new kb 123"
    }
  ],
  "record": true,
  "callback_url": "https://play.svix.com/in/e_pBuXcpDaVzRzwn3L5El4xFFlKnD/",
  "callback_events": [
    "participant_left",
    "max_call_duration_warning",
    "max_call_duration_timeout",
    "action_found"
  ]
}
'

{
  "id": "045302f0-9783-4ff2-846e-3888fb2a7894",
  "message": "Agent created successfully"
}

Authorizations

x-api-key

string

header

required

Body

application/json

name

string

required

Display name for the avatar persona.

Example:

"Sofia - Friendly Support"

system_prompt

string

required

Behavioral prompt for the avatar interaction style.

Example:

"Speak in a warm, engaging tone and provide clear answers."

config

object

required

Agent-level configuration properties.

Show child attributes

config.timeout

integer

Maximum time to wait for the user to join the call (in seconds).

Example:

240

avatar_key_id

string

Avatar identifier key.

Example:

"1e4ea106"

avatars

object[]

List of avatars associated with this agent.

Show child attributes

avatars.config

object

Configuration for avatar behavior and runtime settings.

Show child attributes

avatars.config.llm

object

Large Language Model settings used by the avatar.

Show child attributes

avatars.config.llm.model

string

Identifier of the LLM model.

Example:

"meta-llama/llama-4-maverick-17b-128e-instruct"

avatars.config.llm.provider

string

Provider used for LLM inference.

Example:

"groq"

avatars.config.stt

object

Speech-to-Text model configuration.

Show child attributes

avatars.config.stt.model

string

Speech recognition model identifier.

Example:

"flux-general-en"

avatars.config.stt.provider

string

STT provider service name.

Example:

"deepgram"

avatars.config.stt.min_endpointing_delay

number

Minimum endpointing delay in seconds.

Example:

0.3

avatars.config.stt.max_endpointing_delay

number

Maximum endpointing delay in seconds.

Example:

0.4

avatars.config.tts

object

Text-to-Speech generation configuration.

Show child attributes

avatars.config.tts.model_id

string

Voice synthesis model identifier.

Example:

"eleven_turbo_v2_5"

avatars.config.tts.provider

string

TTS provider service name.

Example:

"elevenlabs"

avatars.config.tts.voice_id

string

Voice ID used to synthesize speech.

Example:

"ZUrEGyu8GFMwnHbvLhv2"

knowledge_base

object[] | null

List of knowledge bases attached to this agent.

Show child attributes

knowledge_base.id

string<uuid>

Knowledge base identifier.

Example:

"ac79226e-73e1-41fe-8cde-469ae4e244fa"

knowledge_base.name

string

Name of the knowledge base.

Example:

"Product Support Articles"

knowledge_base.description

string

Short summary of the knowledge base content.

Example:

"Contains FAQs and troubleshooting guides for product lines."

record

boolean

Determines whether voice call recordings should be stored.

Example:

true

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"

Response

Agent created successfully

string

message

string

Overview Create Agent By Template

⌘I

API Documentation

Video Agents

Persona Templates

Knowledge Base

Providers

Avatars

Authorizations

Body

Response