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. Up to 7 queries supported.

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

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

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"

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.