Get settings | ElevenLabs Documentation

Retrieve Convai settings for the workspace

Successful Response

conversation_initiation_client_data_webhookobject or null

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 or null<=365

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

default_livekit_stackenumDefaults to standard

Allowed values:

422

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	curl https://api.elevenlabs.io/v1/convai/settings \
2	-H "xi-api-key: xi-api-key" \
3	-H "Content-Type: application/json"