Agents Platform

Update Mcp Tool Configuration Override

Changed on

Update configuration overrides for a specific MCP tool.

patch/v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}

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/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}
  • Auth
    none declared

Path parameters

mcp_server_idstring required

ID of the MCP Server.

tool_namestring required

Name of the MCP tool to update config overrides for.

Query parameters

environmentstring

Environment whose values are used when the MCP server URL, headers, or auth connection reference environment variables. Mirrors the environment a conversation would run in; defaults to production.

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.

Request body

force_pre_tool_speechboolean nullable

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

pre_tool_speech'auto' | 'force' | 'off'
disable_interruptionsboolean nullable

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

interruption_mode'allow' | 'disable_during_tool' | 'disable_during_tool_and_turn'
tool_call_sound_behavior'auto' | 'always'

Determines how the tool call sound should be played.

execution_mode'immediate' | 'post_tool_speech' | 'async'
response_timeout_secsinteger nullable

If set, overrides the server's response timeout for this MCP tool.

input_overridesobject nullable

Mapping of json path to input override configuration

Example request

{
  "assignments": [
    {
      "dynamic_variable": "user_name",
      "preserve_native_type": false,
      "sanitize": false,
      "source": "response",
      "value_path": "user.name"
    }
  ]
}

Response

Successful Response

idstring required

Changes

  • f053c821dc18Revision changes
    • breaking

      response property config/tool_config_overrides/items/input_overrides/anyOf[subschema #1]/additionalProperties/oneOf[subschema #1: ConstantSchemaOverride]/constant_value list-of-types was widened by adding types null to media type application/json of response 200

    • info

      request property //// list-of-types was widened by adding types null to media type application/json

  • 1cae8adcc965Revision changes
    • info

      added the optional property / to the response with the status