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.

Pfadparameter

mcp_server_idstringErforderlich

ID of the MCP Server.

tool_namestringErforderlich

Name of the MCP tool to retrieve config overrides for.

Antwort

Successful Response

tool_namestring

The name of the MCP tool

pre_tool_speechenumOptionalStandardwert ist auto

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

Erlaubte Werte:

interruption_modeenumOptionalStandardwert ist allow

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

Erlaubte Werte:

tool_call_soundenum or "off"Optional

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_behaviorenumOptionalStandardwert ist auto

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

Erlaubte Werte:

execution_modeenumOptionalStandardwert ist immediate

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

Erlaubte Werte:

response_timeout_secsintegerOptional5-300

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

assignmentslist of objectsOptional

Dynamic variable assignments for this MCP tool

input_overridesmap from strings to optional objectsOptional

Mapping of json path to input override configuration

response_mockslist of objectsOptional

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

force_pre_tool_speechbooleanOptionalDeprecated

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

disable_interruptionsbooleanOptionalDeprecated

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

Fehler

404

Tool Configs Get Request Not Found Error

422

Tool Configs Get Request Unprocessable Entity Error

Pfadparameter

Header

Antwort

Fehler