Finds catalog and workspace tools that match a described capability.
Ranks every tool in the catalog, and every tool this workspace defined itself (its API tools, scripts and MCP servers' tools), against the words of `query`, in one ranking — a tool matches when any of them appears in its name, its integration or tool id, or its description, and ranks higher the more and the more prominently they do. Each result says where it comes from (`CATALOG` or `WORKSPACE`) and whether this workspace could use it now (`READY`: its integration needs no credentials, or a published config exists) or must connect the integration first (`NEEDS_CONNECTION`). Internal tools are never returned. An empty query returns an empty list.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The tenant identifier
Query Parameters
The maximum number of items to return per page
int32int32Opaque cursor token from an external system (e.g. RAG API). When set, M:Fruxon.Common.Collections.PageToken.AsString returns this value directly instead of encoding Fruxon.Common.Collections.PageToken.Skip.
What the tool should do, in words — e.g. "fetch the content of a web page".
Max results, clamped to 1–50 (default 15).
15int32Response Body
curl -X GET "https://api.fruxon.com/v1/tenants/string/tools:search"{
"items": [
{
"integrationId": "string",
"id": "string",
"displayName": "string",
"description": "string",
"toolType": "API",
"actionType": "READ_ONLY",
"availability": "READY",
"source": "CATALOG"
}
],
"nextPageToken": "string",
"totalCount": 0
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}Runs a tool with the provided parameters.
Resolves the tool by ID within the integration and executes it. When `configId` is set the tool runs against that config's currently published revision — the server resolves its (encrypted) credentials internally, so no secret ever travels in the request. Omit `configId` for SYSTEM / no-auth tools (e.g. File Tools), which run against an empty placeholder config. An optional `resultSelect` previews the agent runtime's `result_select` field projection over a JSON result; it is preview-only and never persisted. Every value in `parameters` must be sent as a JSON <b>string</b>, whatever the parameter's declared type — `"count": "3"`, `"dryRun": "true"`, `"rows": "[[1,2]]"`. The bag is typed server-side against the tool's declared parameters; sending a bare number, boolean or object fails model binding with 400 `"The JSON value could not be converted to System.String"`. The result comes back both ways: `response` is the flattened string form (unchanged), and `resultType` / `jsonValue` / `fileLink` carry the shape the tool actually returned, so a caller need not sniff `response` nor fetch the tool's metadata to learn its type.
List webhooks, optionally filtered by provider.
Returns every webhook in the tenant, or just those for one provider when `provider` is supplied (e.g. `github`, `stripe`). Subscription details are not embedded — fetch them per webhook via `GET WebhookSubscriptions`.