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.tools.list_search(
    query=None,
    provider=None,
    toolbelt=None,
    page_size=20,
    page_token=None,
)

Description

Returns the tools your team can use that match query, optionally restricted to some providers or to the members of one of your toolbelts. Results are ranked across the whole result set: exact tool name matches first, then name or title prefixes, then name or title substrings, then other matches. Cursor-paged with page_size and page_token; no total is reported.

Parameters

query string optional

Matched case- and accent-insensitively as a substring of the tool's name, title, description, category, provider ID, or tool slug. Empty matches every tool your team can use.

provider array of strings optional

Restricts results to these provider IDs, OR'd together. Repeat the parameter to select several. An unknown ID matches nothing.

toolbelt string optional

Restricts results to the members of that toolbelt of your team at its latest version, combined with query and provider as AND. Members are matched at the version the toolbelt pins, which is the same set and the same versions GET /v2/action-gateway/toolbelts/{name} reports. An unknown or deleted toolbelt returns 404 rather than an empty page.

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

A next_page_token from the preceding response. It is pinned to the query and filters that produced it: replaying one against a different search is rejected with 400, not a silent restart from the top.

Response Example

{
  "tools": [
    {
      "tool_slug": "exa_web_search",
      "name": "web_search",
      "title": "Web Search",
      "description": "Search the public web with Exa and return relevant results with normalized text snippets.",
      "provider": "exa",
      "category": "web-search",
      "version": 1
    }
  ],
  "next_page_token": ""
}

More Information

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