How to Destroy Agents Using the Control Panel

Validated on 26 Jun 2025 • Last edited on 8 Jul 2025

GradientAI Platform lets you build fully-managed AI agents with knowledge bases for retrieval-augmented generation, multi-agent routing, guardrails, and more, or use serverless inference to make direct requests to popular foundation models.

Destroy an Agent Using Automation

Destroying an agent using the DigitalOcean API requires the unique identifier of the agent you want to destroy. You can get a list of agents with their unique identifiers with the /v2/gen-ai/agents endpoint.

How to Destroy an Agent Using the DigitalOcean API
  1. Create a personal access token and save it for use with the API.
  2. Send a DELETE request to https://api.digitalocean.com/v2/gen-ai/agents/{uuid}.

cURL

Using cURL:

curl -X DELETE \
  -H "Content-Type: application/json"  \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  "https://api.digitalocean.com/v2/gen-ai/agent/5581a586-a745-11ef-bf8f-4e013e2ddde4"

Destroy an Agent Using the Control Panel

To destroy an agent from the control panel, click Agent Platform from the left menu. From the agent’s More menu, select Destroy. In the Destroy Agent window, enter the agent’s name to confirm that you want to destroy the agent and then click Destroy.

Destroying an agent removes all endpoints for the agent, but does not delete attached knowledge bases, custom models, or agents that the deleted agent routed to. If you are routing to the deleted agent from other agents, you need to update the existing agent’s routing instructions.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.