> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Radera konfigurationsåsidosättning för MCP-verktyg

DELETE https://api.elevenlabs.io/v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}

Ta bort konfigurationsåsidosättningar för ett specifikt MCP-verktyg.

Reference: https://elevenlabs.io/docs/eleven-agents/api-reference/mcp/tool-configuration/delete

## Servers

- `https://api.elevenlabs.io` (Production, default)
- `https://api.us.elevenlabs.io` (Production US)
- `https://api.eu.residency.elevenlabs.io` (Production EU)
- `https://api.in.residency.elevenlabs.io` (Production India)
- `https://api.sg.residency.elevenlabs.io` (Production Singapore)

## Request

### Path parameters

- `mcp_server_id` (string, required) — MCP-serverns ID.
- `tool_name` (string, required) — Namn på MCP-verktyget som konfigurationsåsidosättningar ska tas bort för.

## Response

### 200

Lyckat svar

- `id` (string, required)
- `config` (McpServerConfigOutput, required)
- `metadata` (McpServerMetadataResponseModel, required) — MCP-serverns metadata
- `access_info` (ResourceAccessInfo, optional) — MCP-serverns åtkomstinformation
- `dependent_agents` (list of McpServerResponseModelDependentAgentsItem, optional) — Lista över agenter som är beroende av den här MCP-servern.

## Errors

### 422 Tool Configs Delete Request Unprocessable Entity Error

Valideringsfel

- `detail` (list of ValidationError, optional)

## Types

### McpServerConfigOutput

- `url` (McpServerConfigOutputUrl, required) — Webbadressen till MCP-servern. Om den innehåller en hemlighet ska den lagras som en arbetsytehemlighet, annars som en vanlig sträng. Måste använda https
- `name` (string, required)
- `approval_policy` (enum, optional, default: require_approval_all) — Definierar godkännandepolicyn för verktygskörning på MCP-servernivå.
  - Allowed values: `auto_approve_all`, `require_approval_all`, `require_approval_per_tool`
- `tool_approval_hashes` (list of McpToolApprovalHash, optional) — Lista över godkännandehashar för verktyg för godkännande per verktyg när approval_policy är REQUIRE_APPROVAL_PER_TOOL
- `transport` (enum, optional, default: SSE) — Transporttypen som används för att ansluta till MCP-servern
  - Allowed values: `SSE`, `STREAMABLE_HTTP`
- `secret_token` (McpServerConfigOutputSecretToken, optional) — Den hemliga tokenen (Authorization-headern) som lagras som en hemlighet för arbetsytan eller en direkt angiven hemlighet
- `request_headers` (map from string to McpServerConfigOutputRequestHeadersValue, optional) — Headers som ingår i begäran
- `request_meta` (map from string to McpServerConfigOutputRequestMetaValue, optional) — Poster som skickas i MCP-fältet `_meta` i tools/call-begäranden. Värden kan vara JSON-skalärer eller referenser till en arbetsytehemlighet, dynamisk variabel eller miljövariabel som löses för varje anrop.
- `auth_connection` (McpServerConfigOutputAuthConnection, optional) — Valfri autentiseringsanslutning att använda för autentisering med denna MCP-server
- `description` (string, optional, default: )
- `pre_tool_speech` (enum, optional, default: auto) — Styr om agenten talar innan det här verktyget anropas. 'auto' (standard) avgör utifrån verktygets senaste latens, 'force' ber alltid agenten att tala och 'off' inaktiverar detta helt oavsett latens. Gäller för alla verktyg från den här MCP-servern om det inte åsidosätts per verktyg.
  - Allowed values: `auto`, `force`, `off`
- `interruption_mode` (enum, optional, default: allow) — Styr om användaren kan avbryta agenten kring det här verktygsanropet. 'allow' (standard) låter användaren avbryta när som helst, 'disable_during_tool' förhindrar avbrott endast medan verktyget körs och 'disable_during_tool_and_turn' förhindrar avbrott medan verktyget körs och under agentens efterföljande svar. Gäller för alla verktyg från den här MCP-servern om det inte åsidosätts per verktyg.
  - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
- `tool_call_sound` (enum, optional) — Fördefinierad typ av verktygsanropsljud som spelas under verktygskörning för alla verktyg från denna MCP-server
  - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
- `tool_call_sound_behavior` (enum, optional, default: auto) — Avgör när ljudet för verktygsanrop ska spelas upp för alla verktyg från den här MCP-servern
  - Allowed values: `auto`, `always`
- `execution_mode` (enum, optional, default: immediate) — Avgör när och hur alla verktyg från den här MCP-servern körs: 'immediate' kör verktyget direkt när LLM begär det, 'post_tool_speech' väntar tills agenten har talat färdigt innan det körs, och 'async' kör verktyget i bakgrunden utan att blockera – bäst för långvariga åtgärder.
  - Allowed values: `immediate`, `post_tool_speech`, `async`
- `response_timeout_secs` (integer, optional, default: 30) — Den längsta tiden i sekunder att vänta på att varje MCP-verktygsanrop ska slutföras. Måste vara mellan 5 och 300 sekunder, inklusive gränserna.
- `tool_config_overrides` (list of McpToolConfigOverrideOutput, optional) — Lista över konfigurationsåsidosättningar per verktyg som åsidosätter standardvärden på servernivå för specifika verktyg
- `disable_compression` (boolean, optional, default: false) — Om HTTP-komprimering ska inaktiveras för denna MCP-server. Aktivera detta om servern inte stöder komprimerade svar.
- `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — FÖRÅLDRAT: använd `pre_tool_speech` i stället. Om true kräver alla verktyg från denna MCP-server tal före verktygskörning.
- `disable_interruptions` (boolean, optional, default: false, deprecated) — FÖRÅLDRAT: använd `interruption_mode` i stället. Om true kan användaren inte avbryta agenten medan något verktyg från denna MCP-server körs.

### McpServerMetadataResponseModel

- `created_at` (integer, required)
- `owner_user_id` (string, optional)

### ResourceAccessInfo

- `is_creator` (boolean, required) — Om användaren som gör begäran är agentens skapare
- `creator_name` (string, required) — Namn på agentens skapare
- `creator_email` (string, required) — E-postadress till agentens skapare
- `role` (enum, required) — Rollen för användaren som gör begäran
  - Allowed values: `admin`, `editor`, `commenter`, `viewer`
- `anonymous_access_level_override` (enum, optional) — Åtkomstnivån för anonyma användare. Om värdet är None delas resursen inte offentligt.
  - Allowed values: `admin`, `editor`, `commenter`, `viewer`
- `access_source` (enum, optional) — Varför den begärande användaren har åtkomst till den här resursen. 'creator' = anroparen är ägaren. 'explicit' = anroparen (eller en av deras arbetsytas grupper) finns listad i role_to_group_ids utöver den arbetsyteomfattande gruppen för alla. 'workspace_default' = den arbetsyteomfattande gruppen för alla finns listad i role_to_group_ids (alla icke-anonyma medlemmar i arbetsytan, inklusive administratörer, ser den här resursen). 'workspace_admin' = anroparen är administratör för arbetsytan och administratörsplatsen är den *enda* åtkomstvägen; reserverad för dokument som ingen annan kan se. Gör det möjligt för användargränssnittet att förklara varför en administratör som kringgår behörigheter ser ett dokument som inte uttryckligen har delats med dem.
  - Allowed values: `creator`, `explicit`, `workspace_admin`, `workspace_default`

### McpServerResponseModelDependentAgentsItem

- `type`: `available`
  - `access_level` (enum, required)
    - Allowed values: `admin`, `editor`, `commenter`, `viewer`
  - `created_at_unix_secs` (integer, required)
  - `id` (string, required)
  - `name` (string, required)
  - `referenced_resource_ids` (list of string, optional) — Om agenten är transitivt beroende innehåller detta ID:n för de resurser som agenten är direkt beroende av.
- `type`: `unknown`
  - `id` (string, required)
  - `referenced_resource_ids` (list of string, optional) — Om agenten är transitivt beroende innehåller detta ID:n för de resurser som agenten är direkt beroende av.

### ValidationError

- `loc` (list of ValidationErrorLocItem, required)
- `msg` (string, required)
- `type` (string, required)

### McpServerConfigOutputUrl

Webbadressen till MCP-servern. Om den innehåller en hemlighet ska den lagras som en arbetsytehemlighet, annars som en vanlig sträng. Måste använda https

### McpToolApprovalHash

Modell för lagring av verktygsgodkännande-hashar för godkännande per verktyg.

- `tool_name` (string, required) — Namnet på MCP-verktyget
- `tool_hash` (string, required) — SHA256-hash för verktygets parametrar och beskrivning
- `approval_policy` (enum, optional, default: requires_approval) — Godkännandepolicyn för det här verktyget
  - Allowed values: `auto_approved`, `requires_approval`

### McpServerConfigOutputSecretToken

Den hemliga tokenen (Authorization-headern) som lagras som en hemlighet för arbetsytan eller en direkt angiven hemlighet

### McpServerConfigOutputRequestHeadersValue

### McpServerConfigOutputRequestMetaValue

### McpServerConfigOutputAuthConnection

Valfri autentiseringsanslutning att använda för autentisering med denna MCP-server

### McpToolConfigOverrideOutput

- `tool_name` (string, required) — Namnet på MCP-verktyget
- `pre_tool_speech` (enum, optional, default: auto) — Om angivet åsidosätter det serverns inställning pre_tool_speech för detta verktyg.
  - Allowed values: `auto`, `force`, `off`
- `interruption_mode` (enum, optional, default: allow) — Om angivet åsidosätter det serverns inställning interruption_mode för detta verktyg.
  - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
- `tool_call_sound` (McpToolConfigOverrideOutputToolCallSound, optional) — Åsidosätter serverns inställning tool_call_sound för det här verktyget. Ett ljudnamn spelar upp det ljudet; 'off' innebär inget ljud (tystnad); null innebär att inställningen inte åsidosätts (serverns standardvärde används).
- `tool_call_sound_behavior` (enum, optional, default: auto) — Om angivet åsidosätter det serverns inställning tool_call_sound_behavior för detta verktyg
  - Allowed values: `auto`, `always`
- `execution_mode` (enum, optional, default: immediate) — Om angivet åsidosätter det serverns inställning execution_mode för detta verktyg
  - Allowed values: `immediate`, `post_tool_speech`, `async`
- `response_timeout_secs` (integer, optional) — Om angivet åsidosätter det serverns svarstidsgräns för detta MCP-verktyg (sekunder).
- `assignments` (list of DynamicVariableAssignment, optional) — Tilldelningar av dynamiska variabler för detta MCP-verktyg
- `input_overrides` (map from string to McpToolConfigOverrideOutputInputOverridesValue, optional) — Mappning av JSON-sökväg till konfiguration för åsidosättning av indata
- `response_mocks` (list of ToolResponseMockConfigOutput, optional) — Mock-svar med valfria parametervillkor. Utvärderas uppifrån och ned; den första matchningen används.
- `force_pre_tool_speech` (boolean, optional, deprecated) — FÖRÅLDRAT: använd `pre_tool_speech` i stället. Om det är inställt åsidosätter det serverns inställning force_pre_tool_speech för det här verktyget.
- `disable_interruptions` (boolean, optional, deprecated) — FÖRÅLDRAT: använd `interruption_mode` i stället. Om det är inställt åsidosätter det serverns inställning disable_interruptions för det här verktyget.

### ValidationErrorLocItem

### ConvAiSecretLocator

Används för att referera till en hemlighet från agentens hemlighetslager.

- `secret_id` (string, required)

### ConvAiUserSecretDbModel

Användarspecifik hemlighetsmodell som inte delas med andra användare i en arbetsyta.

- `name` (string, required)
- `encrypted_value` (string, required)
- `nonce` (string, required)
- `id` (string, required)

### ConvAiDynamicVariable

Används för att referera till en dynamisk variabel.

- `variable_name` (string, required)

### ConvAiEnvVarLocator

Används för att referera till en miljövariabel med etikett.

- `env_var_label` (string, required)

### AuthConnectionLocator

Används för att referera till en autentiseringsanslutning från arbetsytans lager för autentiseringsanslutningar.

- `auth_connection_id` (string, required)

### EnvironmentAuthConnectionLocator

Refererar till en miljövariabel av typen 'auth_connection' via etikett. Vid körning löses den till autentiseringsanslutningen för den aktuella miljön, med återgång till standardmiljön.

- `env_var_label` (string, required)

### McpToolConfigOverrideOutputToolCallSound

Åsidosätter serverns inställning tool_call_sound för det här verktyget. Ett ljudnamn spelar upp det ljudet; 'off' innebär inget ljud (tystnad); null innebär att inställningen inte åsidosätts (serverns standardvärde används).

### DynamicVariableAssignment

Konfiguration för att extrahera värden från verktygssvar och tilldela dem till dynamiska variabler.

- `dynamic_variable` (string, required) — Namnet på den dynamiska variabel som det extraherade värdet ska tilldelas
- `value_path` (string, required) — Sökväg med punktnotation för att extrahera värdet från källan (t.ex. 'user.name' eller 'data.0.id')
- `source` ("response", optional) — Källan som värdet ska extraheras från. För närvarande stöds endast 'response'.
- `sanitize` (boolean, optional, default: false) — Om värdet är true tas värdet för denna tilldelning bort från verktygssvaret innan det skickas till LLM och transkriptionen, men behandlas fortfarande för variabeltilldelning.
- `preserve_native_type` (boolean, optional, default: false) — Om värdet är true lagras icke-skalära värden (listor, objekt) som extraherats från verktygssvaret i sin ursprungliga typ i stället för att konverteras till JSON-strängar. Aktivera detta för att använda extraherade arrayer direkt som dynamiska listvariabler.

### McpToolConfigOverrideOutputInputOverridesValue

- `source`: `constant`
  - `constant_value` (ConstantSchemaOverrideConstantValue, optional) — Det konstanta värde som ska användas
- `source`: `dynamic_variable`
  - `dynamic_variable` (string, required) — Namnet på den dynamiska variabel som ska användas
- `source`: `llm`
  - `prompt` (string, optional) — Prompt-åsidosättning för LLM:en. Om den inte anges används den ursprungliga schemabeskrivningen.
- `source`: `omit`

### ToolResponseMockConfigOutput

- `mock_result` (string, required) — Returvärdet som LLM:en ser när denna mock är aktiv.
- `parameter_conditions` (list of UnitTestToolCallParameter, optional) — Om listan är tom aktiveras mocken alltid.
- `is_error` (boolean, optional, default: false) — Om värdet är true visas mockresultatet för LLM som ett verktygsfel i stället för ett lyckat resultat.

### ConstantSchemaOverrideConstantValue

Det konstanta värde som ska användas

### UnitTestToolCallParameter

- `eval` (UnitTestToolCallParameterEval, required)
- `path` (string, required)

### UnitTestToolCallParameterEval

- `type`: `anything`
- `type`: `exact`
  - `expected_value` (string, required) — Det exakta strängvärde som parametern måste matcha.
- `type`: `llm`
  - `description` (string, required) — En beskrivning av utvärderingsstrategin som ska användas för testet.
- `type`: `regex`
  - `pattern` (string, required) — Ett regex-mönster som agentens svar ska matchas mot.

## Examples

**Response**

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

**SDK Code**

```python
import requests

url = "https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name"

response = requests.delete(url)

print(response.json())
```

```javascript
const url = 'https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name';
const options = {method: 'DELETE'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name"

	req, _ := http.NewRequest("DELETE", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.delete("https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('DELETE', 'https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name');

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name");
var request = new RestRequest(Method.DELETE);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "DELETE"

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```