Sign in

v5

OpenAPI 3.1.02026-08-043621,4011.8 MB
Agents Platform

Get Agent Widget Config

Retrieve the widget configuration for an agent

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

Path parameters

agent_idstring required

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

Example:agent_3701k3ttaq12ewp8b7qv5rfyszkz

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

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

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.

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
  }
}