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,
)
Returns JSON Raises HttpResponseError

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_slug string required

Catalog tool slug, for example exa_search. Required.

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

next_page_token from the previous response. Valid only with the same tool selection; otherwise the request is rejected with 400.

Response Example

Show Response Example
{
  "versions": [
    {
      "tool_slug": "supabase_list_organizations",
      "version": "v17",
      "released_at": "2026-11-12T09:30:00Z",
      "latest": true,
      "previous_version": "v16",
      "breaking": true,
      "changes": [
        {
          "type": "requiredScopesAdded",
          "values": [
            "organizations:read"
          ],
          "breaking": true
        }
      ]
    },
    {
      "tool_slug": "supabase_list_organizations",
      "version": "v16",
      "released_at": "2026-10-20T14:05:00Z",
      "latest": false,
      "previous_version": "v15",
      "breaking": false,
      "changes": [
        {
          "type": "inputPropertyAdded",
          "path": "page.cursor",
          "breaking": false
        }
      ]
    }
  ],
  "next_page_token": "djE1"
}

More Information

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

We can't find any results for your search.

Try using different keywords or simplifying your search terms.