Give Feedback

pydo.toolbelts.list_providers()

Generated on 1 Oct 2026 from pydo version v0.43.0

Copy page as Markdown View page as Markdown

Usage

client.toolbelts.list_providers(
    name="search-toolbelt",
    version=None,
    page=1,
    per_page=20,
    search=None,
)

Returns JSONRaises HttpResponseError

Description

Returns the distinct providers of the toolbelt’s members, each with its member count, sorted by provider ID. List one provider’s members with GET .../toolbelts/{name}/providers/{provider}/tools.

Parameters

name string required

Toolbelt name.

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 providers whose ID, name, or description contains this value, case-insensitively.

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

Response Example

Show 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"
  },
  "providers": [
    {
      "provider": "exa",
      "tool_count": 2,
      "id": "exa",
      "name": "Exa",
      "description": "Web search tools backed by Exa.",
      "categories": [
        "web-fetch",
        "web-search"
      ],
      "created_at": "2026-06-01T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 1
  }
}

More Information

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