---
title: "Get Agent Config"
method: GET
path: "/api/v1/livekit/agent-config/{voice_agent_id}"
tags: ["livekit-internal"]
---

# Get Agent Config

`GET /api/v1/livekit/agent-config/{voice_agent_id}`

Get full agent configuration for LiveKit agent worker.

Returns everything needed to run the agent:
- System prompt and first message
- Model settings (LLM, TTS, STT)
- Tools (with parameter schemas)

## Path parameters

- `voice_agent_id` string, uuid, required

## Query parameters

- `customer_number` string, nullable
- `call_external_id` string, nullable
- `trunk_phone` string, nullable
- `dialed_number` string, nullable

## Response `200`

Successful Response

- AgentConfigResponse — Full agent configuration for LiveKit worker.
  - `voice_agent_id` string, required
  - `tenant_id` string, required
  - `name` string, required
  - `system_prompt` string, required
  - `timezone` string, nullable
  - `first_message` string, nullable
  - `model` string, required
  - `temperature` number, required
  - `stt_provider` string, nullable
  - `stt_model` string, nullable
  - `stt_language` string
  - `tts_provider` string, nullable
  - `tts_voice_id` string, nullable
  - `tts_model` string, nullable
  - `tts_speed` number, nullable
  - `tts_pronunciation_dict_id` string, nullable
  - `turn_detection_enabled` boolean
  - `noise_cancellation_enabled` boolean
  - `audio_enhancement_enabled` boolean
  - `end_call_enabled` boolean
  - `record_after_transfer` boolean
  - `min_interruption_duration` number
  - `min_interruption_words` integer
  - `interruption_mode` string
  - `min_endpointing_delay` number
  - `max_endpointing_delay` number
  - `default_tool_filler_message` union
    - string
    - string[]
  - `default_tool_filler_delay_ms` integer, nullable
  - `idle_gate_tool_messages` boolean
  - `background_audio` object, nullable
  - `pre_pickup_message` object, nullable
  - `agent_voice_variants` object[]
  - `stt_context` object, nullable
  - `tools` object[], required
  - `customer_context` object, nullable
  - `outbound_trunk_id` string, nullable
  - `voice_agent_group_id` string, nullable
  - `voice_agent_group_entries` VoiceAgentGroupEntry[], nullable
    - `label` string, required — Label for the transfer target. Max 39 chars because it's prefixed with 'transfer_to_voice_agent__' (25 chars) for a 64-char platform limit.
    - `description` string, nullable
    - `voice_agent_id` string, uuid, required
    - `transfer_config` VoiceTransferScenarioConfig — Operator-configurable transfer behavior for a voice agent entry. Lives on the TARGET entry — the Reservations entry defines how other agents transfer TO Reservations, regardless of which source agent initiates.
      - `condition` string, nullable
      - `pre_instruction` string, nullable
      - `post_instruction` string, nullable
      - `transfer_announcement` 'silent' | 'announced'
      - `speak_first_message_on_transfer` boolean
      - `languages` string[]
  - `normalized_customer_number` string, nullable
  - `bluejay_tool_events_topic` string, nullable
  - `bluejay_agent_external_id` string, nullable
  - `language_prior` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getanana/cleon-api/revisions/c0f54348e251/schema)