Skip to main content
DELETE
/
v1
/
agents
/
{agent_id}
/
tools
/
{tool_id}
Remove Agent Tool
curl --request DELETE \
  --url https://api.xpander.ai/v1/agents/{agent_id}/tools/{tool_id} \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "connection_id": "<string>",
    "operation_id": "<string>",
    "operation_name": "<string>",
    "custom_function_id": "<string>",
    "mcp_id": "<string>",
    "allowed_tools": [
      "<string>"
    ],
    "target_id": "<string>"
  }
]

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
​
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.

​
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.

​
target_id
string | null

Referenced sub-agent or workflow id.