Tools

List available tools

Retrieve a paginated list of available tools with comprehensive filtering, sorting and search capabilities. Use query parameters to narrow down results by toolkit, tags, or search terms.

get/api/v3.1/tools

Query parameters

toolkit_slugstring

The slug of the toolkit to filter by

tool_slugsstring

Comma-separated list of specific tool slugs to retrieve (overrides other filters)

string

string[]

Comma-separated list of auth config IDs to filter tools by

important'true' | 'false'

Filter to only show important/featured tools (set to "true" to enable)

tagsstring[]

Filter tools by one or more tags (can be specified multiple times)

scopesstring[] nullable

Filter tools by one or more scopes (can be specified multiple times)

Array of scopes to filter tools by)

querystring

Full-text search query to filter tools by name, slug, or description. Applied as a soft filter on top of other filters.

searchstring

Deprecated: use "query" instead. Free-text search query to find tools by name, description, or functionality.

include_deprecatedboolean

Include deprecated tools in the response

string

object

Object representation of parsed bracket notation

Toolkit version specification. Use "latest" for latest versions or bracket notation for specific versions per toolkit.

limitnumber nullable

Number of items per page, max allowed is 1000

cursorstring

Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the page number and the limit is the number of items per page. The cursor is used to paginate through the items. The cursor is not required for the first page.

Response

Successfully retrieved tools list with pagination information

next_cursorstring nullable

total_pagesnumber required

current_pagenumber required

total_itemsnumber required

Example response

{
  "items": [
    {
      "slug": "GITHUB_CREATE_A_WORKFLOW_DISPATCH_EVENT",
      "name": "GitHub Actions",
      "description": "Automate GitHub workflows including CI/CD, issue management, and release processes",
      "toolkit": {
        "slug": "github",
        "name": "GitHub",
        "logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png"
      },
      "input_parameters": {
        "repo_name": {
          "type": "string",
          "description": "GitHub repository name in owner/repo format",
          "required": true,
          "example": "octocat/Hello-World"
        },
        "workflow_id": {
          "type": "string",
          "description": "ID or filename of the workflow to trigger",
          "required": true,
          "example": "main.yml"
        }
      },
      "available_versions": [
        "20250905_00",
        "20250906_00"
      ],
      "version": "20250905_00",
      "output_parameters": {
        "run_id": {
          "type": "number",
          "description": "ID of the workflow run that was triggered",
          "example": 12345678
        },
        "status": {
          "type": "string",
          "description": "Status of the workflow run",
          "example": "completed",
          "enum": [
            "queued",
            "in_progress",
            "completed",
            "failed"
          ]
        }
      },
      "scopes": [
        "https://www.googleapis.com/auth/gmail.modify"
      ],
      "scope_requirements": {
        "all_of": [
          "read:user",
          {
            "any_of": [
              "repo",
              "public_repo"
            ]
          }
        ]
      },
      "tags": [
        "ci-cd",
        "github",
        "automation",
        "devops"
      ],
      "human_description": "Create a new issue in a GitHub repository",
      "deprecated": {
        "displayName": "GitHub Actions",
        "version": "20250905_00",
        "available_versions": [
          "20250905_00",
          "20250906_00"
        ],
        "toolkit": {
          "logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png"
        }
      }
    }
  ]
}

Changes

Changed in 4 of the 61 revisions of this API.17

Jul 22, 2026c039e97e7f143See the full diff
- ○
  added the optional property items/items/scope_requirements/all_of/items/anyOf[subschema #2]/any_of/items/anyOf[subschema #2]/source to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/items/scope_requirements/all_of/items/anyOf[subschema #2]/source to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/items/scope_requirements/source to the response with the 200 status
  response-optional-property-added
Jul 16, 2026b61c29327d7412See the full diff
- ▲
  the items/items/scope_requirements/all_of/items/anyOf[subschema #2]/any_of/items/ response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ○
  added the optional property items/items/scope_requirements/all_of/items/anyOf[subschema #2]/when to the response with the 200 status
  response-optional-property-added
- ○
  added subschema #1 subschema #2 to the items/items/scope_requirements/all_of/items/anyOf[subschema #2]/any_of/items/ response property anyOf list for the response status 200
  response-property-any-of-added
Jun 17, 2026589a7d115a5e1See the full diff
- ○
  the endpoint scheme security CookieAuth was removed from the API
  api-security-removed
May 5, 202652c71f747c651See the full diff
- ○
  endpoint added
  endpoint-added

Full history