Skip to content

Delete an Agent

This guide explains how to safely delete agents and manage agent cleanup in RhinoAgents.

Overview

You can delete individual agents or remove all agents from a workspace. Deleting an agent is permanent and will remove:

  • The agent configuration
  • All workflow nodes and connections
  • Associated logs and execution history
  • Integration configurations specific to that agent

Permanent Action

Deleting an agent cannot be undone. Make sure to export or backup any important configurations before deletion.

Delete a Single Agent

From the Dashboard

  1. Navigate to your Customer Dashboard
  2. Find the agent you want to delete in the left sidebar
  3. Click the trash icon (🗑️) next to the agent name
  4. A confirmation dialog will appear
  5. Review the agent details to ensure you're deleting the correct agent
  6. Click Confirm Delete to permanently remove the agent

What Gets Deleted

When you delete an agent, the following items are removed:

  • ✅ Agent configuration and metadata
  • ✅ Workflow nodes and connections
  • ✅ Agent-specific integration settings
  • ✅ Execution logs and history
  • ✅ Scheduled triggers and webhooks
  • ❌ Shared integrations (remain available for other agents)
  • ❌ Workspace settings

Delete All Agents in a Workspace

If you need to clean up an entire workspace, you can delete all agents at once.

Steps to Delete by Workspace

  1. Navigate to the workspace you want to clean up
  2. Go to Workspace Settings from the sidebar
  3. Scroll to the Danger Zone section
  4. Click Delete All Agents in Workspace
  5. Enter the workspace name to confirm
  6. Click Delete All Agents

What Happens

When you delete all agents in a workspace:

  • All agents in the workspace are permanently removed
  • Associated workflows are deleted
  • Integration configurations are removed
  • The workspace itself remains intact
  • You can create new agents in the workspace afterward

Bulk Deletion

This operation deletes all agents simultaneously. The system will log the number of agents deleted for your records.

Before You Delete

Export Agent Configuration

Before deleting an agent, consider exporting its configuration:

  1. Open the agent you want to export
  2. Click the menu icon (⋮) in the top right
  3. Select Export Configuration
  4. Choose export format (JSON or YAML)
  5. Save the file to your local machine

You can import this configuration later to recreate the agent.

Review Dependencies

Check if other systems depend on this agent:

  • Webhooks - External services calling this agent
  • Scheduled Jobs - Automated triggers
  • API Integrations - Other agents or services using this agent
  • User Workflows - Team members relying on this agent

Disable Instead of Delete

If you're unsure about deleting an agent, consider disabling it instead:

  1. Open the agent
  2. Toggle the status switch to Inactive
  3. The agent will stop processing requests but remain configured
  4. You can re-enable it later if needed

After Deletion

Verify Deletion

After deleting an agent:

  1. Check the agent list to confirm removal
  2. Verify that webhooks are no longer active
  3. Update any external integrations that referenced the agent
  4. Inform team members who may have been using the agent

Clean Up External Systems

Don't forget to update external systems:

  • Remove webhook URLs from third-party services
  • Update API documentation
  • Revoke API keys that were specific to the deleted agent
  • Update monitoring and alerting rules

Restore a Deleted Agent

Deleted agents cannot be restored from the system. However, if you exported the configuration:

  1. Go to Agents → Create New Agent
  2. Click Import Configuration
  3. Upload the exported JSON or YAML file
  4. Review and adjust settings as needed
  5. Click Create Agent

New Agent ID

The imported agent will have a new ID and will be treated as a new agent. Historical logs and data from the original agent are not restored.

Troubleshooting

Cannot Delete Agent

If you're unable to delete an agent:

  • Insufficient Permissions - Contact your workspace administrator
  • Agent is Running - Stop the agent first, then delete
  • Active Workflows - Disable any active workflows using the agent

Deletion Failed

If deletion fails:

  1. Check the error message in the notification
  2. Ensure you have proper permissions
  3. Try refreshing the page and attempting again
  4. Contact support if the issue persists

Best Practices

✅ Do: - Export configurations before deletion - Disable agents first to test impact - Document why agents were deleted - Notify team members before deletion - Clean up external integrations

❌ Don't: - Delete agents without backing up configurations - Remove agents that are actively used in production - Forget to update external webhook configurations - Delete without checking dependencies

Next Steps