ElevenLabs CLI

The ElevenLabs CLI v1.0.0 is now available. Every ElevenLabs API operation is available as a subcommand, with JSON, table, YAML and CSV output, automatic pagination and shell completion.

The CLI also provides local configuration workflows for ElevenAgents. Store agent, tool and test configurations as files, synchronize them with push and pull commands, manage branches, run tests, install ElevenLabs UI components and select a data residency region.

Procedures

Procedures are now generally available in ElevenAgents. A procedure contains task-specific instructions and a trigger that determines when they apply. During a conversation, the agent loads the relevant procedure, allowing one agent to handle distinct tasks without placing every instruction in its system prompt.

Use free-form procedures when the agent can adapt the wording or order of instructions. Use structured procedures when steps must run in a defined order. Both types can be used alongside workflows on the same agent.

ElevenAgents

  • Conversation triage tickets: Added APIs for creating tickets about agent performance, creating manual follow-up tickets, listing tickets, assigning workspace members, updating status and assignee, and adding ticket-level or turn-level comments.
  • Conversation observability: Realtime clients can receive a context_usage event after each completed agent turn. The event reports the model, prompt token count and model context limit.

SDK Releases

JavaScript SDK

  • v2.65.0 - Added clients and types for conversation triage tickets and lightweight conversation summaries. Conversation APIs add procedure, invalid-tool-call and sort filters; procedure APIs add agent version selection; topic APIs add evaluation detail controls and frustration sorting. The release also adds knowledge base refresh frequency, test environment and alerting integration fields, plus realtime Dubbing message types.

Python SDK

  • v2.65.0 - Added clients and types for conversation triage tickets and lightweight conversation summaries. Conversation APIs add procedure, invalid-tool-call and sort filters; procedure APIs add agent version selection; topic APIs add evaluation detail controls and frustration sorting. The release also adds knowledge base refresh frequency, test environment and alerting integration fields, and preserves repeated multipart fields for Speech to Text keyterms and Dubbing webhook_ids.

Swift SDK

  • v3.3.0 - Added typed client error parsing, expects_response handling and type-safe tool results. WebRTC startup now becomes ready when the agent joins instead of waiting for audio-track subscription. The release also hardens URL handling, suppresses unknown-event noise and removes realtime-thread allocation from software mute processing.

Packages

API

New Endpoints

ElevenAgents

  • Added nine conversation triage ticket endpoints:
    • Create conversation ticket - POST /v1/convai/triage-tickets. The request requires conversation_id (string) and accepts qa_comment (nullable string, 1–10,000 characters) and up to 200 turn comments.
    • List tickets - GET /v1/convai/agents/{agent_id}/triage-tickets, with cursor pagination.
    • Create manual ticket - POST /v1/convai/agents/{agent_id}/triage-tickets. The request requires qa_comment (string, 1–10,000 characters).
    • List assignable users - GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users. The response lists non-service-account workspace members and whether each member has access to the agent.
    • Get ticket - GET /v1/convai/triage-tickets/{agentqa_ticket_id}.
    • Update ticket - PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. The request accepts optional status and nullable assignee_user_id.
    • Delete ticket - DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}.
    • Add comment - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments. The request requires comment (string, 1–10,000 characters).
    • Add turn comment - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments. The request requires zero-based turn_index (integer) and comment (string, 1–10,000 characters).

Updated Endpoints

ElevenAgents

  • Get signed URL - GET /v1/convai/conversation/get-signed-url
    • Added optional debug_events_request (boolean, default false). Debug events require editor access to the agent.
  • Get WebRTC token - GET /v1/convai/conversation/token
    • Added optional debug_events_request (boolean, default false). The legacy GET /v1/convai/conversation/get_signed_url route accepts the same parameter.
  • List conversations - GET /v1/convai/conversations
    • Added optional triggered_procedure_ids (nullable string array, maximum 50) to match conversations where any specified procedure ran.
    • Added optional include_invalid_tool_calls (boolean, default false) to include tool calls that did not run.
    • Added optional sort_direction (asc or desc, default desc) for call start time.
  • Text search conversation messages - GET /v1/convai/conversations/messages/text-search
    • Added optional triggered_procedure_ids (nullable string array, maximum 50).
    • Added optional include_invalid_tool_calls (boolean, default false).
  • Get agent conversation topics - GET /v1/convai/agents/{agent_id}/topics
    • Added optional include_evaluation_criteria (boolean, default true).
    • Added frustration to sort_by.
    • Topic responses add nullable success_rate (number), while the overall response adds aggregated_run_count (integer, default 0).
    • from_unix_secs is floored to the start of its UTC day. A bounded range aggregates completed daily discovery runs; omitting both bounds returns the latest run.
  • List procedures (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) and Get procedure (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id})
    • Added optional nullable agent_version_id (string) to retrieve procedures from a specific agent version.
  • Create test and Update test
    • Added optional nullable environment (string) to response, simulation and tool-call unit test schemas. The value selects environment-specific URLs, headers and auth connections; it defaults to production.
  • Create URL document, Create crawl job and Create folder
    • Added optional nullable minimum_frequency_days (integer, 1–180) for auto-sync. The default is 7, and a stricter parent-folder frequency takes precedence.

Music

  • List Music Finetunes - GET /v1/music/finetunes
    • Increased the maximum page_size from 100 to 150. The default remains 50.

Schema Changes

ElevenAgents

  • Agent update requests add optional nullable procedures (object<string, ProcedureVersionRef>). Each value requires procedure_id and version_id (strings). An empty object removes all procedures.
  • Conversation initiation configuration adds enable_procedure_ids_from_client (boolean, default false). Initiation data adds optional nullable procedure_ids (string array); an empty array disables all procedures for the starting agent.
  • ClientEvent adds context_usage.
  • Soft-timeout overrides add optional nullable additional_soft_timeout_messages (string array).
  • Constant values in analysis and schema override models now accept null.
  • Widget configuration defaults for mic_muting_enabled and transcript_enabled changed from false to true. Set them explicitly to false to preserve the previous behavior.

Workspace

  • Get user responses removed xi_api_key from UserResponseModel.
  • ResourceMetadataResponseModel.role_to_group_ids now accepts custom role IDs as keys instead of restricting keys to admin, editor, commenter and viewer.
  • Direct publishing responses add optional nullable restricted_to_user_email_domains (string array).
  • Pending subscription switch responses add go to next_tier.