Skip to main content
DELETE
/
api
/
v1
/
agent
/
{agent_id}
/
tools
/
{tool_identifier}
Remove Tool
curl --request DELETE \
  --url https://api.example.com/api/v1/agent/{agent_id}/tools/{tool_identifier}

​
Path Parameters

ParameterTypeDescription
agent_idstringThe agent’s unique identifier
tool_identifierstringThe tool’s UUID or name

​
Behavior

Removal is durable. The endpoint unassigns the tool from the target agent so it is no longer available in that agent’s manifest after restart. If the target is a custom persisted tool and no active agent assignments remain, AgentFlow soft-deletes the tool definition. System tools are never deleted; they can only be unassigned from the target agent. In the Python SDK, call client.agents.tools.delete(agent_id, tool_identifier) for this agent-level removal. Sub-agent assignment removal is exposed separately as client.agents.subagents.unassign_tool(agent_id, subagent_id, tool=tool_identifier).

​
Response

Returns 200 OK with a JSON message payload on success. 
{
  "message": "Tool 'lookup_order' removed successfully from agent 'agent_abc123'"
}