Update configuration override

PATCH

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

PATCH

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

curl -X PATCH "https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name?environment=environment" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "id": "id",
  "config": {
    "url": "url",
    "name": "name",
    "approval_policy": "auto_approve_all",
    "tool_approval_hashes": [
      {
        "tool_name": "tool_name",
        "tool_hash": "tool_hash"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "secret_id"
    },
    "request_headers": {
      "key": "value"
    },
    "request_meta": {
      "key": "value"
    },
    "auth_connection": {
      "auth_connection_id": "auth_connection_id"
    },
    "description": "description",
    "pre_tool_speech": "auto",
    "interruption_mode": "allow",
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 1,
    "tool_config_overrides": [
      {
        "tool_name": "tool_name",
        "assignments": [
          {
            "dynamic_variable": "user_name",
            "value_path": "user.name",
            "source": "response",
            "sanitize": false,
            "preserve_native_type": false
          }
        ]
      }
    ],
    "disable_compression": true
  },
  "metadata": {
    "created_at": 1,
    "owner_user_id": "owner_user_id"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "anonymous_access_level_override": "admin",
    "access_source": "creator"
  },
  "dependent_agents": [
    {
      "type": "available",
      "access_level": "admin",
      "created_at_unix_secs": 1,
      "id": "id",
      "name": "name",
      "referenced_resource_ids": [
        "referenced_resource_ids"
      ]
    }
  ]
}

Update configuration overrides for a specific MCP tool.

パスパラメータ

mcp_server_idstring必須

ID of the MCP Server.

tool_namestring必須

Name of the MCP tool to update config overrides for.

クエリパラメータ

environmentstringオプションデフォルト値 production

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.

リクエスト

This endpoint expects an object.

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.

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.

レスポンス

Successful Response

idstring

configobject

metadataobject

The metadata of the MCP Server

access_infoobjectオプション

The access information of the MCP Server

dependent_agentslist of objectsオプション

List of agents that depend on this MCP Server.

エラー

404

Tool Configs Update Request Not Found Error

422

Tool Configs Update Request Unprocessable Entity Error

パスパラメータ

ヘッダー

クエリパラメータ

リクエスト

レスポンス

エラー