Delete tool
Tools
Delete tool
Delete a tool if it’s not referenced by active agents.
DELETE
Delete tool
Permanently delete a tool. A tool cannot be deleted while it is linked to an active agent. Remove the tool from the agent’s
tool_ids first, or demote the agent.
Agent as tool
Deleting an agent-as-tool removes the tool only. The underlying sub-agent is not affected and remains in its current state.Last modified on June 18, 2026