Skip to main content

Differences between deleting a tool and deleting a tool step

Tool deletion vs. tool step deletion:
  • Delete tool (Tools section): Removes the tool from your project and all agents. This is permanent and cannot be undone.
  • Delete a tool step (Agent Builder → Tools): Removes a single action within an existing tool’s workflow. This cannot be undone.

Delete a tool

When you no longer need a tool, you can delete it from your project. Deleting a tool is permanent and cannot be undone, so check that no agents still depend on it first.
Any agents using this tool will lose access when it is deleted, which may cause errors during task execution. Check which agents use this tool before deleting.

Before you delete

Before deleting a tool, check if any agents are using it:
  1. Navigate to Agents in the left sidebar
  2. Open each agent that might use this tool
  3. Go to the Tools section in the Agent Builder
  4. Check if your tool appears in the agent’s tool list
If agents are using the tool, you’ll need to remove it from those agents first or assign alternative tools to avoid possible execution errors within the agent.

Delete via the UI

  1. Navigate to Tools in the left sidebar (not the Tools section within an agent)
  2. Find the tool you want to delete
  3. Click on the three-dot menu (⋮) in the top right corner
  4. Select Delete
  5. Confirm the deletion when prompted

Delete via Inventor

You can ask Inventor to delete a tool during a conversation.
  1. Open Inventor from the sidebar
  2. Ask Inventor to delete a tool, for example: “Delete the [tool name] tool”
  3. Inventor will prompt you to confirm before proceeding — confirmation is always required for deletions, even when auto-approve is enabled for other actions

What happens when you delete a tool

When you delete a tool:
  • The tool is removed from your project
  • Any agents using this tool will no longer have access to it
  • Bulk runs in progress using this tool may fail
  • Shared links to the tool will stop working
  • The deletion is permanent and cannot be undone

Restore a previous tool version

Inventor can roll an existing tool back to an earlier version. This restores a previous version of a tool — it does not recover a deleted tool.
  1. Open Inventor from the sidebar
  2. Ask Inventor to restore an earlier version, for example: “Restore the previous version of this tool”
  3. Inventor copies the chosen version into the current draft. The live (published) version is unchanged until you publish the draft.
  4. Inventor will prompt you to confirm — confirmation is always required for restore actions, even when auto-approve is enabled

Delete individual tool steps

You can remove specific steps from a tool without deleting the entire tool. This is useful when refining your tool’s workflow or removing unnecessary steps.

Steps to delete a tool step

  1. Open your tool in the Build tab
  2. Find the step you want to remove
  3. Click on the three-dot menu (⋮) in the top right corner of the step
  4. Select Delete step
  5. The step will be removed immediately
Before deleting a step, check if other steps reference its output. If they do, you’ll need to update those references to avoid errors.

What happens when you delete a tool step

When you delete an individual tool step:
  • The step is immediately removed from the tool’s workflow
  • Any subsequent steps that reference this step’s output will show an error
  • You’ll need to update or remove references to the deleted step
  • The deletion takes effect immediately upon saving the tool