For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Connect
BlogHelp CenterAPI PricingSign up
OverviewElevenCreativeElevenAgentsElevenAPIReception AIAPI referenceChangelog
OverviewElevenCreativeElevenAgentsElevenAPIReception AIAPI referenceChangelog
  • Get started
    • Overview
    • Quickstart
  • Configure
    • Overview
    • Voice & language
    • Knowledge base
    • Tools
    • Personalization
    • Authentication
  • Deploy
    • Overview
    • Environment variables
    • WhatsApp
    • Batch calls
  • Monitor
    • Overview
    • Users
    • Testing
    • Experiments
    • Versioning
    • Conversation Analysis
    • Analytics
    • Real-time monitoring
    • OpenTelemetry traces
    • Privacy
    • Cost optimization
    • CLI
  • Advanced
    • Events
    • Custom models
    • LLM cascading
    • Post-call webhooks
  • Resources
    • UI components
  • Guides
    • Chat Mode
    • Burst pricing
    • ElevenLabs' docs agent
    • Scaling user interviews
    • Simulate Conversations
        • WSSAgent WebSockets
          • POSTCreate MCP server
          • DELDelete MCP server
          • GETList MCP servers
          • GETGet MCP server
          • GETList MCP server tools
          • PATCHUpdate MCP server configuration
            • PATCHUpdate MCP server approval policy
            • POSTCreate MCP server tool approval
            • DELDelete MCP server tool approval
LogoLogo
Login
Login
Connect
BlogHelp CenterAPI PricingSign up
API referenceMCPApproval Policies

Delete MCP server tool approval

DELETE
/v1/convai/mcp-servers/:mcp_server_id/tool-approvals/:tool_name
DELETE
/v1/convai/mcp-servers/:mcp_server_id/tool-approvals/:tool_name
$curl -X DELETE https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-approvals/tool_name \
> -H "Content-Type: application/json" \
> -d '{}'
1{
2 "id": "mcp-server-12345",
3 "config": {
4 "url": "https://mcp.example.com/api/v1",
5 "name": "Primary MCP Server",
6 "approval_policy": "require_approval_per_tool",
7 "tool_approval_hashes": [
8 {
9 "tool_name": "weather_forecast",
10 "tool_hash": "a3f5c9d8e7b6f1234567890abcdef1234567890abcdef1234567890abcdef1234",
11 "approval_policy": "requires_approval"
12 }
13 ],
14 "transport": "SSE",
15 "secret_token": {
16 "secret_id": "secret-token-7890"
17 },
18 "request_headers": {
19 "Authorization": "Bearer abcdef1234567890",
20 "X-Custom-Header": "custom-value"
21 },
22 "auth_connection": {
23 "auth_connection_id": "auth-conn-4567"
24 },
25 "description": "Handles tool execution for conversational AI platform",
26 "pre_tool_speech": "auto",
27 "disable_interruptions": false,
28 "tool_call_sound": "typing",
29 "tool_call_sound_behavior": "auto",
30 "execution_mode": "immediate",
31 "response_timeout_secs": 60,
32 "tool_config_overrides": [
33 {
34 "tool_name": "weather_forecast",
35 "pre_tool_speech": "force",
36 "disable_interruptions": true,
37 "tool_call_sound": "elevator2",
38 "tool_call_sound_behavior": "always",
39 "execution_mode": "post_tool_speech",
40 "response_timeout_secs": 120,
41 "assignments": [
42 {
43 "dynamic_variable": "forecast_summary",
44 "value_path": "data.weather.summary",
45 "source": "response",
46 "sanitize": true,
47 "preserve_native_type": false
48 }
49 ],
50 "input_overrides": {
51 "$.location": {
52 "source": "constant",
53 "constant_value": "New York"
54 }
55 },
56 "response_mocks": [
57 {
58 "mock_result": "Rain expected tomorrow, carry an umbrella.",
59 "parameter_conditions": [
60 {
61 "eval": {
62 "type": "regex",
63 "pattern": "^rain.*"
64 },
65 "path": "data.weather.condition"
66 }
67 ]
68 }
69 ],
70 "force_pre_tool_speech": true
71 }
72 ],
73 "disable_compression": false,
74 "force_pre_tool_speech": false
75 },
76 "metadata": {
77 "created_at": 1686000000,
78 "owner_user_id": "user-1234"
79 },
80 "access_info": {
81 "is_creator": true,
82 "creator_name": "John Doe",
83 "creator_email": "john.doe@example.com",
84 "role": "admin",
85 "access_source": "creator"
86 },
87 "dependent_agents": [
88 {
89 "type": "available",
90 "access_level": "admin",
91 "created_at_unix_secs": 1686000000,
92 "id": "agent-98765",
93 "name": "WeatherBot",
94 "referenced_resource_ids": [
95 "agent-98765"
96 ]
97 }
98 ]
99}

Remove approval for a specific MCP tool when using per-tool approval mode.

Was this page helpful?
Previous

Create configuration override

Next
Built with

Path parameters

mcp_server_idstringRequired
ID of the MCP Server.
tool_namestringRequired
Name of the MCP tool to remove approval for.

Headers

xi-api-keystringOptional

Response

Successful Response
idstring
configobject
metadataobject
The metadata of the MCP Server
access_infoobject or null
The access information of the MCP Server
dependent_agentslist of objects
List of agents that depend on this MCP Server.

Errors

422
Unprocessable Entity Error