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.create(
    body={
        "name": "search-toolbelt",
        "version": "1",
        "display_name": "Search Tools",
        ...,
    },
)

Description

A toolbelt is a named set of tools, each pinned to a version, that your team can attach to sessions as toolbelt:<name>@<version>. The first version is 1 unless version is set. Returns 409 if an active toolbelt with the same name exists. The name of a deleted toolbelt can be reused; its versions start again from the initial version.

Parameters

name string required

Example: search-toolbelt

Toolbelt name, unique among your team's active toolbelts. Must match ^[a-z]`[a-z0-9_-]{0,63}$; search` is reserved.

version string optional

Example: 1

Optional initial version number, a positive integer such as 1. Defaults to 1.

Default: 1

display_name string optional

Example: Search Tools

Optional human-readable label, separate from name. At most 128 bytes.

Max length: 128

description string optional

Example: Tools for searching and fetching public web pages.

Optional description. At most 255 bytes.

Max length: 255

tools array of strings optional

Example: ['exa_web_search', 'exa_web_fetch']

Optional initial members, as catalog tool slugs (<provider>_<name>). Each may be pinned as <tool_slug>@<version>; a pin must equal the tool's current released version, and an unpinned tool is pinned to that version. Every tool must be an active catalog tool. Duplicates are merged; at most 500 tools. Empty creates a toolbelt with no tools.

Request Sample

import os
from pydo import Client

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

req = {
  "name": "search-toolbelt",
  "display_name": "Search Tools",
  "description": "Tools for searching and fetching public web pages.",
  "tools": [
    "exa_web_search",
    "exa_web_fetch"
  ]
}

resp = client.toolbelts.create(body=req)

Response Example

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

More Information

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