Agents Platform

Get Agent Widget Config

Changed on

Retrieve the widget configuration for an agent

get/v1/convai/agents/{agent_id}/widget

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/agents/{agent_id}/widget
  • Auth
    none declared

Path parameters

agent_idstring required

The id of an agent. This is returned on agent creation.

Example:agent_3701k3ttaq12ewp8b7qv5rfyszkz

Query parameters

conversation_signaturestring nullable

An expiring token that enables a websocket conversation to start. These can be generated for an agent using the /v1/convai/conversation/get_signed_url endpoint

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

agent_idstring required

Example response

{
  "widget_config": {
    "file_input_config": {
      "enabled": false,
      "max_files_in_memory": 10,
      "max_files_per_conversation": 10
    },
    "first_message": "Hello! How can I help you today?",
    "language": "en",
    "language_presets": {},
    "supported_language_overrides": [
      "es",
      "fr"
    ],
    "supports_text_only": true,
    "text_only": false,
    "use_rtc": false
  }
}

Changes

  • 47dc9e66d680Revision changes
    • info

      added the optional property / to the response with the status

  • 775d1f02f1a7Revision changes
    • info

      added the optional property / to the response with the status