Create configuration override

POST

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

POST

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

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

{
  "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"
      ]
    }
  ]
}

Create configuration overrides for a specific MCP tool.

Parametry ścieżki

mcp_server_idstringWymagany

ID of the MCP Server.

Parametry zapytania

environmentstringOpcjonalnyDomyślnie 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.

Żądanie

This endpoint expects an object.

tool_namestringWymagany

The name of the MCP tool

pre_tool_speechenumOpcjonalnyDomyślnie auto

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

Dozwolone wartości:

interruption_modeenumOpcjonalnyDomyślnie allow

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

Dozwolone wartości:

tool_call_soundenum or "off"Opcjonalny

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_behaviorenumOpcjonalnyDomyślnie auto

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

Dozwolone wartości:

execution_modeenumOpcjonalnyDomyślnie immediate

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

Dozwolone wartości:

response_timeout_secsintegerOpcjonalny5-300

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

assignmentslist of objectsOpcjonalny

Dynamic variable assignments for this MCP tool

input_overridesmap from strings to optional objectsOpcjonalny

Mapping of json path to input override configuration

response_mockslist of objectsOpcjonalny

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

force_pre_tool_speechbooleanOpcjonalnyDeprecated

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

disable_interruptionsbooleanOpcjonalnyDeprecated

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

Odpowiedź

Successful Response

idstring

configobject

metadataobject

The metadata of the MCP Server

access_infoobjectOpcjonalny

The access information of the MCP Server

dependent_agentslist of objectsOpcjonalny

List of agents that depend on this MCP Server.

Błędy

409

Tool Configs Create Request Conflict Error

422

Tool Configs Create Request Unprocessable Entity Error

Parametry ścieżki

Nagłówki

Parametry zapytania

Żądanie

Odpowiedź

Błędy