Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

elevenlabs Agents API

Endpoints for creating, managing, and configuring conversational AI agents with voice capabilities.

elevenlabs Agents API is one of 22 APIs that elevenlabs publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an AsyncAPI specification.

This API exposes 6 operations across 3 paths, and defines 9 schemas. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against a single base URL, https://api.elevenlabs.io.

6 operations 3 paths 9 schemas 1 DELETE2 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Base URL
https://api.elevenlabs.io
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

elevenlabs Agents API declares 1 security scheme for authenticating requests. An API key is passed in the header as xi-api-key (apiKeyAuth). By default, every request must be authenticated.

  • apiKeyAuth — ElevenLabs API key passed in the xi-api-key header for authentication.

Paths & Operations 6

Across 3 paths, the API surfaces 6 operations — 1 DELETE, 2 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Agents 6

Endpoints for creating, managing, and configuring conversational AI agents with voice capabilities.

GET
/v1/convai/agents
List agents
listAgents 2 params → 200401
POST
/v1/convai/agents
Create agent
createAgent body → 200400401422
GET
/v1/convai/agents/{agent_id}
Get agent
getAgent 1 param → 200401404
PATCH
/v1/convai/agents/{agent_id}
Update agent
updateAgent 1 param body → 200400401404
DELETE
/v1/convai/agents/{agent_id}
Delete agent
deleteAgent 1 param → 200401404
POST
/v1/convai/agents/{agent_id}/simulate
Simulate conversation
simulateConversation 1 param body → 200400401404

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are Agent (5 properties), ConversationConfig (4 properties), UpdateAgentRequest (3 properties), CreateAgentRequest (3 properties). Each schema is shown below with its type and property counts.

AgentResponse
object
1 property
AgentListResponse
object
3 properties
UpdateAgentRequest
object
3 properties
AgentSummary
object
3 properties
SimulateConversationRequest
object
2 properties
CreateAgentRequest
object
3 properties 1 required
ConversationConfig
object
Configuration defining the agent's conversational behavior, voice settings, and language model parameters.
4 properties
Agent
object
5 properties
SimulationResult
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

elevenlabs-agents-api-openapi.yml Raw ↑

Other APIs elevenlabs publishes across the network.

elevenlabs Audio Isolation API
elevenlabs Audio Native API
elevenlabs Chapters API
elevenlabs Conversations API
elevenlabs Dubbing API
elevenlabs Dubbing Resources API
elevenlabs Instant Voice Cloning API
elevenlabs Knowledge Base API
elevenlabs Music Generation API
elevenlabs Professional Voice Cloning API
elevenlabs Projects API
elevenlabs Pronunciation Dictionaries API