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_search(
    query=None,
    status="active",
    page_size=20,
    page_token=None,
)

Description

Returns your team’s toolbelts whose name, display name, or description contains query, case-insensitively, sorted by name. Cursor-paged with page_size and page_token; no total is reported.

Parameters

query string optional

Matched case-insensitively as a substring of name, display_name, or description. Empty matches every toolbelt of your team.

status string optional

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

One of: active, deprecated, all

Default: active

page_size integer optional

Page size, 1 to 100. Defaults to 20 when omitted or 0; other values are rejected with 400.

Min: 1

Max: 100

Default: 20

page_token string optional

next_page_token from the previous response. Valid only with the same query and status; otherwise the request is rejected with 400.

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."
    }
  ],
  "next_page_token": ""
}

More Information

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