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.list(
    status="active",
    page=1,
    per_page=20,
)

Description

Returns your team’s toolbelts, one entry per name describing its latest version, sorted by name. Offset-paged with page and per_page; pagination reports the total.

Parameters

status string optional

active (default), deprecated, or all. Case-insensitive.

One of: active, deprecated, all

Default: active

page integer optional

1-based page number. Values below 1 are treated as 1.

Min: 1

Default: 1

per_page integer optional

Page size. Defaults to 20; values above 100 are capped at 100.

Min: 1

Max: 100

Default: 20

Pagination

This method returns paginated results. The response includes a links.pages object with URLs for navigating between pages. To retrieve the next page, parse the next URL and pass the page parameter:

from urllib.parse import urlparse, parse_qs

resp = client.toolbelts.list()
pages = resp.get("links", {}).get("pages", {})

while "next" in pages:
    parsed = urlparse(pages["next"])
    page = int(parse_qs(parsed.query)["page"][0])
    resp = client.toolbelts.list(page=page)
    pages = resp.get("links", {}).get("pages", {})

Response Example

{
  "toolbelts": [
    {
      "name": "search-toolbelt",
      "display_name": "Search Tools",
      "latest_version": "1",
      "version_count": 1,
      "tool_count": 2,
      "status": "active",
      "reference_latest": "search-toolbelt",
      "updated_at": "2026-06-11T12:00:00Z",
      "description": "Tools for searching and fetching public web pages."
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 1
  }
}

More Information

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