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_provider_tools(
    name="search-toolbelt",
    provider="exa",
    version=None,
    page=1,
    per_page=20,
    search=None,
)

Description

Returns a page of catalog metadata for the toolbelt’s members from the named provider, sorted by tool slug. An unknown provider returns an empty page.

Parameters

name string required

Toolbelt name.

provider string required

A provider ID from the toolbelt's provider list, or _legacy for members recorded without a provider. Matched exactly.

version string optional

Version number to read. Empty reads the latest version.

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

search string optional

Restricts tools whose slug, name, title, description, provider, or category contains this value, case-insensitively, within the provider only.

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_provider_tools(name="search-toolbelt", provider="exa", )
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_provider_tools(name="search-toolbelt", provider="exa", page=page)
    pages = resp.get("links", {}).get("pages", {})

Response Example

{
  "tools": [
    {
      "tool_slug": "exa_web_fetch",
      "name": "web_fetch",
      "title": "Web Fetch",
      "description": "Fetch the contents of a public web page with Exa.",
      "provider": "exa",
      "category": "web-fetch",
      "version": 1
    },
    {
      "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
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 2
  }
}

More Information

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