GEgetanana
voice_agent_groups

Update Voice Agent Group

Changed on

Update an existing voice agent group.

put/api/v1/voice-ai/voice-agent-groups/{group_id}

Request

Path parameters

group_idstring uuid required

Request body

namestring nullable
enabledboolean nullable
pre_pickup_enabledboolean nullable
pre_pickup_mode'audio' | 'text' | 'synthesized'

How a group's pre-pickup message is sourced before the AI picks up.

  • AUDIO: play the operator-uploaded file at pre_pickup_audio_object_key.
  • TEXT: synthesize pre_pickup_text live with the group's TTS voice at call time.
  • SYNTHESIZED: a message pre-rendered from pre_pickup_text with an operator-chosen provider/voice/language (the "recipe" columns), stored to the same audio slot as AUDIO and played identically by the worker.

Enum grows, never renames.

pre_pickup_textstring nullable
pre_pickup_voice_provider'elevenlabs' | 'cartesia' | 'google'

TTS provider used to synthesize a SYNTHESIZED pre-pickup message.

Stored on VoiceAgentGroup.pre_pickup_voice_provider (as a plain string column) and used to dispatch synthesis to the matching TTS client.

pre_pickup_voice_idstring nullable
pre_pickup_languagestring nullable
pre_pickup_menu_grace_secondsnumber nullable

Response

Successful Response

idstring uuid required
pre_pickup_enabledboolean
pre_pickup_mode'audio' | 'text' | 'synthesized'

How a group's pre-pickup message is sourced before the AI picks up.

  • AUDIO: play the operator-uploaded file at pre_pickup_audio_object_key.
  • TEXT: synthesize pre_pickup_text live with the group's TTS voice at call time.
  • SYNTHESIZED: a message pre-rendered from pre_pickup_text with an operator-chosen provider/voice/language (the "recipe" columns), stored to the same audio slot as AUDIO and played identically by the worker.

Enum grows, never renames.

pre_pickup_textstring nullable
pre_pickup_voice_provider'elevenlabs' | 'cartesia' | 'google'

TTS provider used to synthesize a SYNTHESIZED pre-pickup message.

Stored on VoiceAgentGroup.pre_pickup_voice_provider (as a plain string column) and used to dispatch synthesis to the matching TTS client.

pre_pickup_voice_idstring nullable
pre_pickup_languagestring nullable
pre_pickup_menu_grace_secondsnumber nullable
namestring required
enabledboolean
direction'inbound' | 'outbound'

Whether the group handles inbound calls or outbound calls.

tenant_idstring uuid required
created_atstring date-time required
updated_atstring date-time required
pre_pickup_audio_filenamestring nullable

Changes

  • f074102ed7ebRevision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

  • 84afa6f06b87Revision changes
    • info

      added the optional property to the response with the status