Skip to main content
DELETE
Remove Agent Tool

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

agent_id
string
required
tool_id
string
required

Query Parameters

deploy
boolean
default:true

Deploy the agent after removing so the change takes effect immediately.

Response

Successful Response

id
string
required

Stable handle for this attached tool. Pass it to DELETE to remove the tool.

type
enum<string>
required

The kind of attached tool.

Available options:
action,
custom_function,
mcp,
agent,
workflow,
skill
name
string | null

Human-readable tool name.

connection_id
string | null

Connector connection id. Actions only.

operation_id
string | null

Operation catalog id. Actions only.

operation_name
string | null

OpenAPI operationId. Actions only.

use_mock
boolean | null

Operation serves AI-generated mock data instead of the real API. Actions only.

custom_function_id
string | null

Custom function id. Custom functions only.

mcp_id
string | null

MCP registry id. MCP only.

allowed_tools
string[] | null

Subset of MCP tools exposed. MCP only.

mcp_url
string | null

MCP server url. MCP only.

mcp_auth_type
string | null

MCP auth type (api_key/oauth2/custom_headers/none). MCP only.

mcp_registry_id
string | null

Registry entry id when this MCP is attached from the shared org registry (editing it affects every agent). Absent for inline MCPs. MCP only.

mcp_transport
string | null

MCP transport (streamable-http/sse/stdio). MCP only.

mcp_headers
string[] | null

Custom header names configured on the MCP (keys only; values are never returned). MCP only.

mcp_client_id
string | null

OAuth2 client id for the MCP, if set. MCP only.

mcp_additional_scopes
string[] | null

Extra OAuth2 scopes for the MCP. MCP only.

mcp_share_user_token
boolean | null

Whether the authorized MCP token is shared across the org's other agents. MCP only.

mcp_has_api_key
boolean | null

Whether an API key is stored for the MCP (the value is never returned). MCP only.

mcp_has_client_secret
boolean | null

Whether an OAuth2 client secret is stored for the MCP (the value is never returned). MCP only.

target_id
string | null

Referenced sub-agent or workflow id.

skill_name
string | null

Skill name from the xpander skills catalog. Skills only.