MCP टूल कॉन्फ़िगरेशन ओवरराइड बनाएं

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 \
     -H "Content-Type: application/json" \
     -d '{
  "tool_name": "string"
}'

{
  "id": "string",
  "config": {
    "url": "string",
    "name": "string",
    "approval_policy": "require_approval_all",
    "tool_approval_hashes": [
      {
        "tool_name": "string",
        "tool_hash": "string",
        "approval_policy": "requires_approval"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "string"
    },
    "request_headers": {},
    "request_meta": {},
    "auth_connection": {
      "auth_connection_id": "string"
    },
    "description": "",
    "pre_tool_speech": "auto",
    "interruption_mode": "allow",
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 30,
    "tool_config_overrides": [
      {
        "tool_name": "string",
        "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": "string",
            "value_path": "string",
            "source": "response",
            "sanitize": false,
            "preserve_native_type": false
          }
        ],
        "input_overrides": {},
        "response_mocks": [
          {
            "mock_result": "string",
            "parameter_conditions": [
              {
                "eval": {
                  "description": "string",
                  "type": "string"
                },
                "path": "string"
              }
            ],
            "is_error": false
          }
        ],
        "force_pre_tool_speech": true,
        "disable_interruptions": true
      }
    ],
    "disable_compression": false,
    "force_pre_tool_speech": false,
    "disable_interruptions": false
  },
  "metadata": {
    "created_at": 1,
    "owner_user_id": "string"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "access_source": "creator"
  },
  "dependent_agents": [
    {
      "type": "available",
      "access_level": "admin",
      "created_at_unix_secs": 1,
      "id": "string",
      "name": "string",
      "referenced_resource_ids": [
        "string"
      ]
    }
  ]
}

किसी खास MCP टूल के लिए कॉन्फ़िगरेशन ओवरराइड बनाएं।

Path parameters

mcp_server_idstringRequired

MCP सर्वर की ID।

Query parameters

environmentstringOptionalDefaults to production

वह environment जिसकी वैल्यू तब इस्तेमाल होती हैं, जब MCP सर्वर URL, headers या auth connection environment variables को रेफ़र करते हैं। यह उस environment जैसा होता है जिसमें बातचीत चलती; डिफ़ॉल्ट रूप से production है।

Request

This endpoint expects an object.

tool_namestringRequired

MCP टूल का नाम

pre_tool_speechenum or nullOptionalDefaults to auto

सेट होने पर, इस टूल के लिए सर्वर की pre_tool_speech सेटिंग को ओवरराइड करता है।

Allowed values:

interruption_modeenum or nullOptionalDefaults to allow

सेट होने पर, इस टूल के लिए सर्वर की interruption_mode सेटिंग को ओवरराइड करता है।

Allowed values:

tool_call_soundenum or "off" or nullOptional

इस tool के लिए server की tool_call_sound setting को override करता है। sound name उस sound को चलाता है; ‘off’ का मतलब कोई sound नहीं (silence); null का मतलब override न करें (server default अपनाएं)।

tool_call_sound_behaviorenum or nullOptionalDefaults to auto

सेट होने पर, इस टूल के लिए सर्वर की tool_call_sound_behavior सेटिंग को ओवरराइड करता है

Allowed values:

execution_modeenum or nullOptionalDefaults to immediate

सेट होने पर, इस टूल के लिए सर्वर की execution_mode सेटिंग को ओवरराइड करता है

Allowed values:

response_timeout_secsinteger or nullOptional5-300

सेट होने पर, इस MCP टूल के लिए सर्वर के रिस्पॉन्स टाइमआउट को ओवरराइड करता है।

assignmentslist of objects or nullOptional

इस MCP टूल के लिए डायनामिक वेरिएबल असाइनमेंट

input_overridesmap from strings to objects or nullOptional

json पाथ और इनपुट ओवरराइड कॉन्फ़िगरेशन की मैपिंग

response_mockslist of objects or nullOptional

वैकल्पिक पैरामीटर शर्तों वाले मॉक जवाब। ऊपर से नीचे तक मूल्यांकन होता है; पहला मैच चुना जाता है।

force_pre_tool_speechboolean or nullOptionalDeprecated

डीप्रिकेटेड: इसके बजाय pre_tool_speech इस्तेमाल करें। सेट होने पर यह इस टूल के लिए सर्वर की force_pre_tool_speech सेटिंग को ओवरराइड करता है।

disable_interruptionsboolean or nullOptionalDeprecated

डीप्रिकेटेड: इसके बजाय interruption_mode इस्तेमाल करें। सेट होने पर यह इस टूल के लिए सर्वर की disable_interruptions सेटिंग को ओवरराइड करता है।

Response

सफल रिस्पॉन्स

idstring

configobject

metadataobject

MCP सर्वर का मेटाडेटा

access_infoobject or nullOptional

MCP सर्वर की एक्सेस जानकारी

dependent_agentslist of objectsOptional

इस MCP Server पर निर्भर एजेंट की सूची।

Errors

409

Conflict Error

422

Unprocessable Entity Error

Path parameters

Headers

Query parameters

Request

Response

Errors