Sign in

v2

latestOpenAPI 3.0.0Proprietary2026-08-07936826.0 KB
Tool Router

Search for tools using a query

Search for tools matching a given use case query within a tool router session. Returns matching tool slugs, full tool schemas, toolkit connection statuses, and workflow guidance in a predictable format.

post/api/v3/tool_router/session/{session_id}/search

Path parameters

session_idstring toolRouterSessionId required

Tool router session ID (trs_*)

Example:trs_LX9uJKBinWWr

Tool router session ID (trs_*)

Request body

modelstring

Optional model hint for search/planning behavior (e.g., "gpt-4o"). Ignored if invalid.

Example request

{
  "queries": [
    {
      "use_case": "Send a slack message to a channel"
    }
  ],
  "model": "gpt-4o"
}

Response

Successfully executed the search. Returns matching tool slugs, schemas, connection statuses, and guidance.

successboolean required

Whether all searches completed successfully. False if any query failed.

errorstring nullable required

Error message if any searches failed, null if all succeeded. Format: "X out of Y searches failed, reasons: <details>"

tool_schemasobject required

Deduplicated tool definitions keyed by tool_slug for O(1) lookup. Each tool appears once even if used in multiple queries.

next_steps_guidancestring[] required

Combined workflow guidance covering connections, planner, and memory usage. Each element is a step instruction.