Get configuration override

GET

/v1/convai/mcp-servers/:mcp_server_id/tool-configs/:tool_name

GET

/v1/convai/mcp-servers/:mcp_server_id/tool-configs/:tool_name

curl https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name

{
  "tool_name": "tool_name",
  "pre_tool_speech": "auto",
  "interruption_mode": "allow",
  "tool_call_sound": "typing",
  "tool_call_sound_behavior": "auto",
  "execution_mode": "immediate",
  "response_timeout_secs": 1,
  "assignments": [
    {
      "dynamic_variable": "user_name",
      "value_path": "user.name",
      "source": "response",
      "sanitize": false,
      "preserve_native_type": false
    }
  ],
  "input_overrides": {
    "key": {
      "source": "constant",
      "constant_value": "constant_value"
    }
  },
  "response_mocks": [
    {
      "mock_result": "mock_result",
      "parameter_conditions": [
        {
          "eval": {
            "type": "anything"
          },
          "path": "path"
        }
      ],
      "is_error": true
    }
  ],
  "force_pre_tool_speech": true,
  "disable_interruptions": true
}

Retrieve configuration overrides for a specific MCP tool.

路径参数

mcp_server_idstring必需

ID of the MCP Server.

tool_namestring必需

Name of the MCP tool to retrieve config overrides for.

响应

Successful Response

tool_namestring

The name of the MCP tool

pre_tool_speechenum可选默认为 auto

If set, overrides the server’s pre_tool_speech setting for this tool.

允许的值:

interruption_modeenum可选默认为 allow

If set, overrides the server’s interruption_mode setting for this tool.

允许的值:

tool_call_soundenum or "off"可选

Overrides the server’s tool_call_sound setting for this tool. A sound name plays that sound; ‘off’ overrides to no sound (silence); null means do not override (inherit the server default).

tool_call_sound_behaviorenum可选默认为 auto

If set, overrides the server’s tool_call_sound_behavior setting for this tool

允许的值:

execution_modeenum可选默认为 immediate

If set, overrides the server’s execution_mode setting for this tool

允许的值:

response_timeout_secsinteger可选5-300

If set, overrides the server’s response timeout for this MCP tool (seconds).

assignmentslist of objects可选

Dynamic variable assignments for this MCP tool

input_overridesmap from strings to optional objects可选

Mapping of json path to input override configuration

response_mockslist of objects可选

Mock responses with optional parameter conditions. Evaluated top-to-bottom; first match wins.

force_pre_tool_speechboolean可选Deprecated

DEPRECATED: use pre_tool_speech instead. If set, overrides the server’s force_pre_tool_speech setting for this tool.

disable_interruptionsboolean可选Deprecated

DEPRECATED: use interruption_mode instead. If set, overrides the server’s disable_interruptions setting for this tool.

错误

404

Tool Configs Get Request Not Found Error

422

Tool Configs Get Request Unprocessable Entity Error

路径参数

请求头

响应

错误