> ## Documentation Index > Fetch the complete documentation index at: https://docs.liveavatar.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Voice Agent > Retrieve a voice agent, including its full `agent_configuration`. ## OpenAPI ````yaml /openapi.json get /v1/voice_agents/{agent_id} openapi: 3.1.0 info: title: Live avatar API version: 0.1.0 servers: - url: https://api.liveavatar.com security: [] paths: /v1/voice_agents/{agent_id}: get: tags: - Voice Agents summary: Get Voice Agent description: Retrieve a voice agent, including its full `agent_configuration`. operationId: get_voice_agent_v1_voice_agents__agent_id__get parameters: - name: agent_id in: path required: true schema: type: string title: Agent Id - name: la_session in: cookie required: false schema: title: La Session type: string responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Response_VoiceAgentResponseSchema_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: Response_VoiceAgentResponseSchema_: properties: code: type: integer title: Code default: 100 data: anyOf: - $ref: '#/components/schemas/VoiceAgentResponseSchema' - type: 'null' message: title: Message type: string type: object title: Response[VoiceAgentResponseSchema] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError VoiceAgentResponseSchema: properties: id: type: string title: Id name: type: string title: Name agent_type: $ref: '#/components/schemas/VoiceAgentTypeEnum' agent_configuration: oneOf: - $ref: '#/components/schemas/FullAgentConfigSchema' - $ref: '#/components/schemas/ElevenLabsAgentConfigSchema-Output' - $ref: '#/components/schemas/CartesiaAgentConfigSchema-Output' title: Agent Configuration discriminator: propertyName: agent_type mapping: cartesia_agent: $ref: '#/components/schemas/CartesiaAgentConfigSchema-Output' elevenlabs_agent: $ref: '#/components/schemas/ElevenLabsAgentConfigSchema-Output' liveavatar_agent: $ref: '#/components/schemas/FullAgentConfigSchema' created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At type: object required: - id - name - agent_type - agent_configuration - created_at - updated_at title: VoiceAgentResponseSchema description: A voice agent, including its full `agent_configuration`. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: title: Message type: string type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError VoiceAgentTypeEnum: type: string enum: - liveavatar_agent - elevenlabs_agent - cartesia_agent title: VoiceAgentTypeEnum description: >- How a voice agent's conversation is run. * `liveavatar_agent` — the managed speech-to-text => LLM => text-to-speech pipeline. * `elevenlabs_agent` — an agent you host on ElevenLabs, referenced by id. * `cartesia_agent` — an agent you host on Cartesia, referenced by id. FullAgentConfigSchema: properties: agent_type: type: string const: liveavatar_agent title: Agent Type default: liveavatar_agent mode: $ref: '#/components/schemas/SessionModeEnum' default: FULL voice_id: type: string format: uuid title: Voice Id description: Voice used by the pipeline TTS stage context_id: title: Context Id description: Context ID type: string format: uuid language: type: string title: Language description: Language default: en voice_settings: anyOf: - oneOf: - $ref: '#/components/schemas/ElevenLabsVoiceSettings' - $ref: '#/components/schemas/FishAudioVoiceSettings' - $ref: '#/components/schemas/CartesiaVoiceSettings' discriminator: propertyName: provider mapping: cartesia: $ref: '#/components/schemas/CartesiaVoiceSettings' elevenLabs: $ref: '#/components/schemas/ElevenLabsVoiceSettings' fish: $ref: '#/components/schemas/FishAudioVoiceSettings' - type: 'null' title: Voice Settings description: >- Additional voice settings (provider-specific, discriminated by 'provider' field) stt_config: anyOf: - $ref: '#/components/schemas/STTConfigSchema-Output' - type: 'null' description: ASR/STT configuration override additionalProperties: false type: object required: - voice_id title: FullAgentConfigSchema description: >- `agent_configuration` for a `liveavatar_agent`. The conversation runs on the managed speech-to-text => LLM => text-to-speech pipeline, using the voice, context, and language selected here. Unknown fields are rejected rather than silently ignored, and the language must be supported by the chosen speech-to-text provider and text-to-speech model. ElevenLabsAgentConfigSchema-Output: properties: agent_type: type: string const: elevenlabs_agent title: Agent Type default: elevenlabs_agent mode: $ref: '#/components/schemas/SessionModeEnum' default: LITE agent_id: type: string minLength: 1 title: Agent Id description: ElevenLabs Agent ID secret_id: type: string format: uuid title: Secret Id description: Secret ID referencing an ELEVENLABS_API_KEY secret additionalProperties: false type: object required: - agent_id - secret_id title: ElevenLabsAgentConfigSchema description: >- `agent_configuration` for an `elevenlabs_agent`. The conversation is handled by an agent you host on ElevenLabs, referenced by its `agent_id` plus one of your stored secrets holding an ElevenLabs API key. The key is held by reference only and is never returned. Unknown fields are rejected rather than silently ignored, including fields that belong to a `liveavatar_agent` configuration. CartesiaAgentConfigSchema-Output: properties: agent_type: type: string const: cartesia_agent title: Agent Type default: cartesia_agent mode: $ref: '#/components/schemas/SessionModeEnum' default: LITE agent_id: type: string minLength: 1 title: Agent Id description: Cartesia Agent ID secret_id: type: string format: uuid title: Secret Id description: Secret ID referencing a CARTESIA_API_KEY secret additionalProperties: false type: object required: - agent_id - secret_id title: CartesiaAgentConfigSchema description: >- `agent_configuration` shape for the `cartesia` agent type. References a Cartesia-hosted agent by id plus a stored secret; the secret is held by reference only (`secret_id` → `space_secrets`), never inline. Mirrors `ElevenLabsAgentConfigSchema` exactly — field names align with the LITE-session `CartesiaAgentConfigSchema` (`src/sessions/session_token_schema.py`) so the session-start path can map one onto the other without renaming. `extra="forbid"` rejects unknown keys (and any liveavatar_agent fields sent against the wrong type) at write time. SessionModeEnum: type: string enum: - FULL - LITE title: SessionModeEnum ElevenLabsVoiceSettings: properties: provider: type: string const: elevenLabs title: Provider default: elevenLabs speed: type: number maximum: 1.2 minimum: 0.8 title: Speed default: 1 stability: type: number maximum: 1 minimum: 0 title: Stability default: 0.75 similarity_boost: type: number maximum: 1 minimum: 0 title: Similarity Boost default: 0.75 style: type: number maximum: 1 minimum: 0 title: Style default: 0 use_speaker_boost: type: boolean title: Use Speaker Boost default: true model: $ref: '#/components/schemas/ElevenLabsModelEnum' description: >- ElevenLabs TTS model. Options: 'eleven_flash_v2_5' (default, faster) or 'eleven_multilingual_v2' (better quality). default: eleven_flash_v2_5 apply_language_text_normalization: type: boolean title: Apply Language Text Normalization description: >- Apply ElevenLabs language-specific text normalization. Improves pronunciation for languages with complex orthography — currently only Japanese ('ja') is supported. Enabling this adds latency, so it is opt-in and only valid when the session language is set to 'ja'. default: false type: object title: ElevenLabsVoiceSettings description: ElevenLabs-specific voice settings for TTS configuration. FishAudioVoiceSettings: properties: provider: type: string const: fish title: Provider default: fish speed: type: number maximum: 1.2 minimum: 0.8 title: Speed default: 1 model: $ref: '#/components/schemas/FishAudioModelEnum' description: Fish Audio TTS model. default: s2 latency_mode: type: string enum: - normal - balanced title: Latency Mode description: 'Latency mode: ''normal'' (~500ms) or ''balanced'' (~300ms).' default: balanced type: object title: FishAudioVoiceSettings description: Fish Audio-specific voice settings for TTS configuration. CartesiaVoiceSettings: properties: provider: type: string const: cartesia title: Provider default: cartesia speed: type: number maximum: 1.5 minimum: 0.6 title: Speed default: 1 model: $ref: '#/components/schemas/CartesiaModelEnum' description: Cartesia TTS model. default: sonic-3.5 type: object title: CartesiaVoiceSettings description: Cartesia-specific voice settings for TTS configuration. STTConfigSchema-Output: properties: provider: $ref: '#/components/schemas/STTProviderEnum' description: STT provider. Auto-selected if not specified. type: object required: - provider title: STTConfigSchema description: User-provided STT configuration. ElevenLabsModelEnum: type: string enum: - eleven_flash_v2_5 - eleven_multilingual_v2 title: ElevenLabsModelEnum FishAudioModelEnum: type: string enum: - s1 - s2 title: FishAudioModelEnum CartesiaModelEnum: type: string enum: - sonic-3.5 - sonic-3 - sonic-2 - sonic-turbo title: CartesiaModelEnum STTProviderEnum: type: string enum: - deepgram - assembly_ai - gladia - elevenlabs title: STTProviderEnum securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-KEY ````