Give Feedback

pydo.toolbelts.get()

Generated on 1 Oct 2026 from pydo version v0.43.0

Copy page as Markdown View page as Markdown

Usage

client.toolbelts.get(
    name="search-toolbelt",
    version=None,
    page_size=20,
    page_token=None,
    search=None,
)

Returns JSONRaises HttpResponseError

Description

Returns the latest version of the named toolbelt, or the version requested, with catalog metadata for one page of its members in tool_details. A deleted toolbelt returns 404 unless a version is requested.

Parameters

name string required

Toolbelt name.

version string optional

Version number to read. Empty returns the latest version.

page_size integer optional

Page size for tool_details only; toolbelt.tools always lists every member. Defaults to 20; values above 100 are capped at 100.

Min: 1

Max: 100

Default: 20

page_token string optional

next_page_token from the previous response, to continue tool_details. Treat it as opaque, and send it only with the same toolbelt, version, and search.

search string optional

Restricts tool_details to members whose tool slug, name, title, description, provider, or category contains this value, case-insensitively. It does not filter toolbelt.tools. This is a substring match, not a filter expression.

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"
  },
  "tool_details": [
    {
      "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
    }
  ],
  "next_page_token": ""
}

More Information

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