Tools

Searches the caller's available tools by keyword and returns a ranked list of matches. Use this to browse what tools exist; use Select Tools to get tools for a specific task.

post/v1/tools/search

Request

  • Base URL
    https://api.arcade.dev
  • Auth
    API key in header Authorization

Request body

categoriesstring[]

Categories filters results to tools in any of these categories.

gateway_idstring

GatewayID scopes the search to a specific gateway's tool allow list. When empty, the caller's full CATE-allowed tool universe is searched.

include_staticboolean

IncludeStatic controls whether STATIC (builtin / statically configured) tools appear in results. Defaults to true when omitted.

querystring required

Query is the free-text search string. Required, non-blank.

tagsstring[]

Tags filters results to tools tagged with any of these labels.

top_kinteger

TopK is the maximum number of results to return. Absent applies the default of 10 and is capped at 50; a present value must be positive.

user_idstring

The user to search as. Required only when calling with an API key.

Response

OK

Changes