Remove Agent Tool
Remove a tool from an agent by its tool id (the id returned by List Agent Tools).
Authorizations
API Key for authentication
Query Parameters
Deploy the agent after removing so the change takes effect immediately.
Response
Successful Response
Stable handle for this attached tool. Pass it to DELETE to remove the tool.
The kind of attached tool.
action, custom_function, mcp, agent, workflow, skill Human-readable tool name.
Connector connection id. Actions only.
Operation catalog id. Actions only.
OpenAPI operationId. Actions only.
Operation serves AI-generated mock data instead of the real API. Actions only.
Custom function id. Custom functions only.
MCP registry id. MCP only.
Subset of MCP tools exposed. MCP only.
MCP server url. MCP only.
MCP auth type (api_key/oauth2/custom_headers/none). MCP only.
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 (streamable-http/sse/stdio). MCP only.
Custom header names configured on the MCP (keys only; values are never returned). MCP only.
OAuth2 client id for the MCP, if set. MCP only.
Extra OAuth2 scopes for the MCP. MCP only.
Whether the authorized MCP token is shared across the org's other agents. MCP only.
Whether an API key is stored for the MCP (the value is never returned). MCP only.
Whether an OAuth2 client secret is stored for the MCP (the value is never returned). MCP only.
Referenced sub-agent or workflow id.
Skill name from the xpander skills catalog. Skills only.

