September 14, 2026

New endpoints

ElevenAgents

• Upload agent hold audio - POST /v1/convai/agents/{agent_id}/hold-audio
  • Accepts required hold_audio_file (binary) as multipart form data. The file must be MP3 or WAV, up to 40 MB and 180 seconds.
  • Returns required agent_id (string) and hold_audio (AgentHoldAudioConfig). The hold-audio object requires audio_path, audio_url, original_filename (strings), duration_secs (number) and size_bytes (integer).
• Delete agent hold audio - DELETE /v1/convai/agents/{agent_id}/hold-audio
  • Removes the custom clip so queued callers hear the default hold tone.
  • Returns required agent_id (string).

Updated endpoints

ElevenAgents

• Create agent, Get agent and Update agent
  • Added optional platform_settings.queueing_config (AgentQueueingConfig) with enabled (boolean, default false) and wait_timeout_seconds (integer, 1–1,800, default 180).
  • Queue configuration responses include read-only nullable hold_audio (AgentHoldAudioConfig). Agent responses also include optional default_hold_audio_url (string).
• Get conversation - GET /v1/convai/conversations/{conversation_id}
  • Metadata adds optional nullable queue_wait_secs (number). Queue time is excluded from call_duration_secs and billed time.
• Create agent branch - POST /v1/convai/agents/{agent_id}/branches
  • Added optional include_draft (boolean, default false). When true, a branch created from the branch tip includes the caller's draft procedure set.
• List procedures and procedure create, get and draft endpoints
  • List items add optional referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids and referenced_dynamic_variables (string arrays).
  • Agent and merge-preview responses add optional procedures, a map keyed by procedure ID.
• List test invocations - GET /v1/convai/test-invocations
  • Added optional nullable search (string) to filter tests and folders by name.
• Run tests on agent and Get test invocation
  • Test suite invocation and unit test run responses add optional nullable version_id (string) and optional ran_against_draft (boolean, default false).
  • Invocation summaries also add optional runs_diverged_from_version (boolean, default false).
• POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query
  • The request body adds optional nullable max_documents_length (integer, 1–50,000) and max_retrieved_rag_chunks_count (integer, 1–20) query-specific overrides.
• Get WhatsApp account - GET /v1/convai/whatsapp-accounts/{phone_number_id}
  • Added optional account_type (WhatsAppAccountType, default cloud_api). Values are cloud_api and coexistence.
• Calculate expected LLM usage - POST /v1/convai/agent/{agent_id}/llm-usage/calculate
  • LLMUsageCalculatorLLMResponseModel adds required price_per_message (number).

Music

• MusicModelID adds music_v2_5 for POST /v1/music/video-to-music, POST /v1/music/plan, Compose music, POST /v1/music/detailed, POST /v1/music/detailed/stream, POST /v1/music/stream, POST /v1/music/upload and POST /v1/music/finetunes.
• GenerationChunk.text increases maxLength from 6,000 to 6,132 characters for POST /v1/music/plan, POST /v1/music, POST /v1/music/detailed, POST /v1/music/detailed/stream, POST /v1/music/stream and POST /v1/music/upload. Section names can contain 1–100 characters, and chunks can contain up to 30 lines with 200 characters per line.

Schema changes

ElevenAgents

• Real-time server events add queue_status. Its required queue_status_event.status accepts waiting, admitted or timed_out; timed_out precedes WebSocket close code 4300. Hold audio continues to arrive as regular audio events.
• The LLM enum adds gemini-3.8-flash, including conversation initiation overrides.
• Conversation system tool result unions add start_procedure_success, start_procedure_error, end_procedure_success and end_procedure_error.
• FeaturesUsageCommonModel adds optional freeform_procedure and structured_procedure feature statuses.