For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Usage

client.toolbelts.delete_tools(
    name="search-toolbelt",
    body={
        "tools": [...],
    },
)

Description

Removes the listed tools and returns the toolbelt. When membership changes, this creates a new version that keeps the display name and description. Tools that are not members are ignored, and removing every tool is allowed; deleting the toolbelt itself is a separate DELETE. Returns 400 when a pin differs from the version the toolbelt holds, and 404 for an unknown or deleted toolbelt.

Parameters

name string required

Toolbelt name, from the path.

tools array of strings required

Example: ['exa_web_search']

Tool slugs (<provider>_<name>) to add or remove, each optionally pinned as <tool_slug>@<version>. At least one is required. When adding, a pin must equal the tool's current released version.

Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

req = {
  "tools": [
    "exa_web_fetch"
  ]
}

resp = client.toolbelts.delete_tools(name="search-toolbelt", body=req)

Response Example

{
  "toolbelt": {
    "name": "search-toolbelt",
    "version": "2",
    "display_name": "Search Tools",
    "description": "Tools for searching and fetching public web pages.",
    "tools": [
      "exa_web_search@1"
    ],
    "status": "active",
    "reference": "search-toolbelt@2",
    "reference_latest": "search-toolbelt",
    "tool_count": 1,
    "created_at": "2026-06-11T12:00:00Z",
    "updated_at": "2026-06-12T09:30:00Z"
  }
}

More Information

See /v2/action-gateway/toolbelts/{name}/tools/remove in the API reference for additional detail on responses, headers, parameters, and more.