Get settings | ElevenLabs Documentation

Retrieve Convai settings for the workspace

Successful Response

conversation_initiation_client_data_webhookobject

webhooksobject

can_use_mcp_serversbooleanDefaults to false

Whether the workspace can use MCP servers

rag_retention_period_daysinteger<=30Defaults to 10

conversation_embedding_retention_daysinteger<=365

Days to retain conversation embeddings. None means use the system default (30 days).

default_livekit_stackenumDefaults to standard

Allowed values:

422

Settings Get Request Unprocessable Entity Error

1	{
2	"conversation_initiation_client_data_webhook": {
3	"url": "https://hooks.myworkspace.com/convai/initiate",
4	"request_headers": {
5	"Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
6	"Content-Type": "application/json"
7	}
8	},
9	"webhooks": {
10	"post_call_webhook_id": "webhook_123abc456def",
11	"events": [
12	"transcript",
13	"call_initiation_failure"
14	],
15	"send_audio": false
16	},
17	"can_use_mcp_servers": true,
18	"rag_retention_period_days": 14,
19	"conversation_embedding_retention_days": 30,
20	"default_livekit_stack": "standard"
21	}

1	from elevenlabs import ElevenLabs
2
3	client = ElevenLabs()
4
5	client.conversational_ai.settings.get()