Skip to main content
POST
Search for tools using a query

Authorizations

x-api-key
string
header
default:your-project-api-key
required

Your Composio project API key. Create or copy it from the Composio dashboard.

Path Parameters

session_id
string<toolRouterSessionId>
required

Tool router session ID (trs_*)

Example:

"trs_LX9uJKBinWWr"

Body

application/json
queries
object[]
required

List of search queries to execute in parallel.

Required array length: 1 - 7 elements
Example:
model
string

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

Example:

"gpt-4o"

search_strategy
enum<string>

Search path to use. Defaults to auto. Use tool_search to bypass cached plans and run direct tool search.

Available options:
auto,
tool_search
Example:

"tool_search"

experimental
object

Inline custom tools and toolkits for this request. v3.1 sessions do not persist customs — pass them on every request that needs them.

Response

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

success
boolean
required

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

error
string | null
required

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

"

results
object[]
required

Per-query search results with tools, reasoning, and memory. One entry per query in request order.

toolkit_connection_statuses
object[]
required

Connection status for all toolkits mentioned across all queries, with descriptions merged in.

tool_schemas
object
required

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

time_info
object
required

Time information for the query

session
object
required

Session info for correlating meta tool calls

next_steps_guidance
string[]
required

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