dots.v2.actionGateway.tools.search.get()

Generated on 5 Nov 2026 from DoTs version v1.23.0

Usage

client.v2.actionGateway.tools.search.get(requestConfiguration?: RequestConfiguration<SearchRequestBuilderGetQueryParameters>): Promise<undefined | Search_tools_response>

Description

Returns the tools your team can use that match query, optionally restricted to some providers or to the members of one of your toolbelts. Results are ranked across the whole result set: exact tool name matches first, then name or title prefixes, then name or title substrings, then other matches. Cursor-paged with page_size and page_token; no total is reported.

Parameters

query string optional

Example: search

Matched case- and accent-insensitively as a substring of the tool's name, title, description, category, provider ID, or tool slug. Empty matches every tool your team can use.

provider array of strings optional

Example: ["exa"]

Restricts results to these provider IDs, OR'd together. Repeat the parameter to select several. An unknown ID matches nothing.

toolbelt string optional

Example: search-toolbelt

Restricts results to the members of that toolbelt of your team at its latest version, combined with query and provider as AND. Members are matched at the version the toolbelt pins, which is the same set and the same versions GET /v2/action-gateway/toolbelts/{name} reports. An unknown or deleted toolbelt returns 404 rather than an empty page.

pageSize integer optional

Example: 20

Page size, 1 to 100. Defaults to 20 when omitted or 0; other values are rejected with 400.

Default: 20

Min: 1

Max: 100

pageToken string optional

Example: ZXhhX3dlYl9zZWFyY2hAMQ

A next_page_token from the preceding response. It is pinned to the query and filters that produced it: replaying one against a different search is rejected with 400, not a silent restart from the top.

Request Sample

Show Request Sample
import { FetchRequestAdapter } from "@microsoft/kiota-http-fetchlibrary";
import {
    createDigitalOceanClient,
    DigitalOceanApiKeyAuthenticationProvider,
} from "@digitalocean/dots";

const authProvider = new DigitalOceanApiKeyAuthenticationProvider(process.env.DIGITALOCEAN_TOKEN!);
const adapter = new FetchRequestAdapter(authProvider);
const client = createDigitalOceanClient(adapter);

const response = await client.v2.actionGateway.tools.search.get();

Response Example

Show Response Example
{
  "tools": [
    {
      "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/tools/search 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.