pydo.tools.list_versions()
Generated on 20 Nov 2026
from pydo version
v0.47.0
Usage
client.tools.list_versions(
tool_slug="exa_web_search",
page_size=20,
page_token=None,
)Description
Returns the released versions of one catalog tool, newest first, each with the changes from the version released before it. Every version listed can be pinned as <tool_slug>@<version> in an endpoint or toolbelt, and a pin keeps calling that version after newer versions are released. A tool named without a version always calls the latest release, marked latest.
Changes are computed by comparing each version’s input schema, output schema, and required OAuth scopes with the previous released version. breaking marks a change that can make a call that worked against the previous version fail; review those before moving a pin or relying on the latest release. Returns 404 when tool_slug is not a catalog tool. Tools of your team’s MCP servers are not listed.
Parameters
tool_slugstring requiredCatalog tool slug, for example
exa_search. Required.page_sizeinteger optionalPage size, 1 to 100. Defaults to 20 when omitted or 0; other values are rejected with 400.
page_tokenstring optionalnext_page_tokenfrom the previous response. Valid only with the same tool selection; otherwise the request is rejected with 400.
Response Example
More Information
See /v2/action-gateway/tools/{tool_slug}/versions in the API reference for additional detail on responses, headers, parameters, and more.