Update MCP server approval policy

curl -X PATCH https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/approval-policy \
     -H "Content-Type: application/json" \
     -d '{
  "approval_policy": "require_approval_all"
}'

{
  "id": "mcp-123e4567-e89b-12d3-a456-426614174000",
  "config": {
    "url": "https://mcp.example.com/api/v1/tools",
    "name": "Primary MCP Server",
    "approval_policy": "require_approval_all",
    "tool_approval_hashes": [
      {
        "tool_name": "DataFetcher",
        "tool_hash": "a3f5c8d9e7b1f2a4c6d8e9f0b1a2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0",
        "approval_policy": "requires_approval"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "secret-7890abcd-1234-ef56-7890-abcdef123456"
    },
    "request_headers": {},
    "auth_connection": {
      "auth_connection_id": "authconn-4567def8-1234-5678-9abc-def123456789"
    },
    "description": "Handles tool execution with strict approval policies.",
    "pre_tool_speech": "auto",
    "disable_interruptions": false,
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 30,
    "tool_config_overrides": [
      {
        "tool_name": "DataFetcher",
        "pre_tool_speech": "auto",
        "disable_interruptions": true,
        "tool_call_sound": "typing",
        "tool_call_sound_behavior": "auto",
        "execution_mode": "immediate",
        "response_timeout_secs": 10,
        "assignments": [
          {
            "dynamic_variable": "fetched_data",
            "value_path": "data.results",
            "source": "response",
            "sanitize": false,
            "preserve_native_type": true
          }
        ],
        "input_overrides": {},
        "response_mocks": [
          {
            "mock_result": "{\"status\":\"success\",\"data\":[]}",
            "parameter_conditions": [
              {
                "eval": {
                  "type": "exact",
                  "description": "Must exactly match 'test_mode'"
                },
                "path": "mode"
              }
            ]
          }
        ],
        "force_pre_tool_speech": true
      }
    ],
    "disable_compression": false,
    "force_pre_tool_speech": false
  },
  "metadata": {
    "created_at": 1685996400,
    "owner_user_id": "user-1234abcd-5678-ef90-1234-abcdef567890"
  },
  "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": 1686000000,
      "id": "agent-1234abcd-5678-ef90-1234-abcdef567890",
      "name": "Support Chatbot",
      "referenced_resource_ids": [
        "agent-9876abcd-1234-5678-9abc-def123456789"
      ]
    }
  ]
}

curl -X PATCH https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/approval-policy \
     -H "Content-Type: application/json" \
     -d '{
  "approval_policy": "require_approval_all"
}'

{
  "id": "mcp-123e4567-e89b-12d3-a456-426614174000",
  "config": {
    "url": "https://mcp.example.com/api/v1/tools",
    "name": "Primary MCP Server",
    "approval_policy": "require_approval_all",
    "tool_approval_hashes": [
      {
        "tool_name": "DataFetcher",
        "tool_hash": "a3f5c8d9e7b1f2a4c6d8e9f0b1a2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0",
        "approval_policy": "requires_approval"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "secret-7890abcd-1234-ef56-7890-abcdef123456"
    },
    "request_headers": {},
    "auth_connection": {
      "auth_connection_id": "authconn-4567def8-1234-5678-9abc-def123456789"
    },
    "description": "Handles tool execution with strict approval policies.",
    "pre_tool_speech": "auto",
    "disable_interruptions": false,
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 30,
    "tool_config_overrides": [
      {
        "tool_name": "DataFetcher",
        "pre_tool_speech": "auto",
        "disable_interruptions": true,
        "tool_call_sound": "typing",
        "tool_call_sound_behavior": "auto",
        "execution_mode": "immediate",
        "response_timeout_secs": 10,
        "assignments": [
          {
            "dynamic_variable": "fetched_data",
            "value_path": "data.results",
            "source": "response",
            "sanitize": false,
            "preserve_native_type": true
          }
        ],
        "input_overrides": {},
        "response_mocks": [
          {
            "mock_result": "{\"status\":\"success\",\"data\":[]}",
            "parameter_conditions": [
              {
                "eval": {
                  "type": "exact",
                  "description": "Must exactly match 'test_mode'"
                },
                "path": "mode"
              }
            ]
          }
        ],
        "force_pre_tool_speech": true
      }
    ],
    "disable_compression": false,
    "force_pre_tool_speech": false
  },
  "metadata": {
    "created_at": 1685996400,
    "owner_user_id": "user-1234abcd-5678-ef90-1234-abcdef567890"
  },
  "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": 1686000000,
      "id": "agent-1234abcd-5678-ef90-1234-abcdef567890",
      "name": "Support Chatbot",
      "referenced_resource_ids": [
        "agent-9876abcd-1234-5678-9abc-def123456789"
      ]
    }
  ]
}

Update the approval policy configuration for an MCP server. DEPRECATED: Use PATCH /mcp-servers/{id} endpoint instead.

Path parameters

mcp_server_idstringRequired

ID of the MCP Server.

Request

This endpoint expects an object.

approval_policyenumRequiredDefaults to require_approval_all

The approval mode to set for the MCP server

Allowed values:

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

Update MCP server approval policy

Path parameters

Headers

Request

Response

Errors

Path parameters

Headers

Request

Response

Errors

$	curl -X PATCH https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/approval-policy \
>	-H "Content-Type: application/json" \
>	-d '{
>	"approval_policy": "require_approval_all"
>	}'

1	{
2	"id": "mcp-123e4567-e89b-12d3-a456-426614174000",
3	"config": {
4	"url": "https://mcp.example.com/api/v1/tools",
5	"name": "Primary MCP Server",
6	"approval_policy": "require_approval_all",
7	"tool_approval_hashes": [
8	{
9	"tool_name": "DataFetcher",
10	"tool_hash": "a3f5c8d9e7b1f2a4c6d8e9f0b1a2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0",
11	"approval_policy": "requires_approval"
12	}
13	],
14	"transport": "SSE",
15	"secret_token": {
16	"secret_id": "secret-7890abcd-1234-ef56-7890-abcdef123456"
17	},
18	"request_headers": {},
19	"auth_connection": {
20	"auth_connection_id": "authconn-4567def8-1234-5678-9abc-def123456789"
21	},
22	"description": "Handles tool execution with strict approval policies.",
23	"pre_tool_speech": "auto",
24	"disable_interruptions": false,
25	"tool_call_sound": "typing",
26	"tool_call_sound_behavior": "auto",
27	"execution_mode": "immediate",
28	"response_timeout_secs": 30,
29	"tool_config_overrides": [
30	{
31	"tool_name": "DataFetcher",
32	"pre_tool_speech": "auto",
33	"disable_interruptions": true,
34	"tool_call_sound": "typing",
35	"tool_call_sound_behavior": "auto",
36	"execution_mode": "immediate",
37	"response_timeout_secs": 10,
38	"assignments": [
39	{
40	"dynamic_variable": "fetched_data",
41	"value_path": "data.results",
42	"source": "response",
43	"sanitize": false,
44	"preserve_native_type": true
45	}
46	],
47	"input_overrides": {},
48	"response_mocks": [
49	{
50	"mock_result": "{\"status\":\"success\",\"data\":[]}",
51	"parameter_conditions": [
52	{
53	"eval": {
54	"type": "exact",
55	"description": "Must exactly match 'test_mode'"
56	},
57	"path": "mode"
58	}
59	]
60	}
61	],
62	"force_pre_tool_speech": true
63	}
64	],
65	"disable_compression": false,
66	"force_pre_tool_speech": false
67	},
68	"metadata": {
69	"created_at": 1685996400,
70	"owner_user_id": "user-1234abcd-5678-ef90-1234-abcdef567890"
71	},
72	"access_info": {
73	"is_creator": true,
74	"creator_name": "John Doe",
75	"creator_email": "john.doe@example.com",
76	"role": "admin",
77	"access_source": "creator"
78	},
79	"dependent_agents": [
80	{
81	"type": "available",
82	"access_level": "admin",
83	"created_at_unix_secs": 1686000000,
84	"id": "agent-1234abcd-5678-ef90-1234-abcdef567890",
85	"name": "Support Chatbot",
86	"referenced_resource_ids": [
87	"agent-9876abcd-1234-5678-9abc-def123456789"
88	]
89	}
90	]
91	}