Update settings

Update Convai settings for the workspace

This endpoint expects an object.

conversation_initiation_client_data_webhookobjectOptional

webhooksobjectOptional

can_use_mcp_serversbooleanOptionalDefaults to false

Whether the workspace can use MCP servers

rag_retention_period_daysintegerOptional<=30Defaults to 10

conversation_embedding_retention_daysintegerOptional<=365

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

default_livekit_stackenumOptional

Allowed values:

Successful Response

conversation_initiation_client_data_webhookobject or null

webhooksobject or null

can_use_mcp_serversboolean or nullDefaults to false

Whether the workspace can use MCP servers

rag_retention_period_daysinteger or null<=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_stackenum or null

Allowed values:

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

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