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.add_tools(
    name="search-toolbelt",
    body={
        "tools": [...],
    },
)

Description

Adds the listed tools and returns the toolbelt. When membership changes, this creates a new version that keeps the display name and description. Tools already in the toolbelt are left as they are, so a request that adds nothing new returns the current version unchanged. Returns 400 when a tool is not an active catalog tool, when a pin differs from the tool’s current released version or from the version the toolbelt already holds, or when the toolbelt would exceed 500 tools. Returns 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": [
    "jira_create_issue"
  ]
}

resp = client.toolbelts.add_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_fetch@1",
      "exa_web_search@1",
      "jira_create_issue@1"
    ],
    "status": "active",
    "reference": "search-toolbelt@2",
    "reference_latest": "search-toolbelt",
    "tool_count": 3,
    "created_at": "2026-06-11T12:00:00Z",
    "updated_at": "2026-06-12T09:30:00Z"
  }
}

More Information

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