Agents Platform

Get Convai Settings

Changed on

Retrieve Convai settings for the workspace

get/v1/convai/settings

Request

  • Base URL
    https://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.elevenlabs.io/v1/convai/settings
  • Auth
    none declared

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

Successful Response

can_use_mcp_serversboolean

Whether the workspace can use MCP servers

rag_retention_period_daysinteger
conversation_embedding_retention_daysinteger nullable

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

default_livekit_stack'standard' | 'static'

Example response

{
  "conversation_initiation_client_data_webhook": {
    "request_headers": {
      "Content-Type": "application/json"
    },
    "url": "https://example.com/webhook"
  }
}

Changes

  • d942e69ff7a7Revision changes
    • info

      added the optional property / to the response with the status

  • 7ac648a154bbRevision changes
    • warning

      added the new answering_machine_detection enum value to the // response property for the response status