Search for tools using a query
Search for tools matching a use case query within an existing tool router session.
Path parameters
Tool router session ID (trs_*)
Tool router session ID (trs_*)
Request body
Example request
{
"queries": [
{
"use_case": "Send a slack message to a channel"
}
],
"model": "gpt-4o",
"experimental": {
"custom_toolkits": [
{
"slug": "ecommerce",
"name": "E-Commerce API",
"description": "Internal e-commerce API for order management and fulfillment",
"tools": [
{
"slug": "GET_CUSTOMER_ORDERS",
"name": "Get Customer Orders",
"description": "Fetch recent orders for a customer by their email address",
"input_schema": {
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Customer email"
}
},
"required": [
"email"
]
}
}
]
}
],
"custom_tools": [
{
"slug": "GET_IMPORTANT_EMAILS",
"name": "Get Important Emails",
"description": "Fetch emails marked as important from the last 24 hours",
"input_schema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Max results to return"
}
}
},
"extends_toolkit": "gmail"
}
]
}
}Response
Successfully executed the search. Returns matching tool slugs, schemas, connection statuses, and guidance.
Changes
Changed in 4 of the 61 revisions of this API.8
- ○
the endpoint scheme security
CookieAuthwas removed from the APIapi-security-removed
- ○
the endpoint scheme security
UserApiKeyAuthwas removed from the APIapi-security-removed
- ○
- ○
added the optional property
//to the response with the statusresponse-optional-property-added
- ○
added the optional property
////to the response with the statusresponse-optional-property-added
- ○
- ○
added the new optional request property
///new-optional-request-property
- ○
added the new optional request property
/////new-optional-request-property
- ○
added the new optional request property
///new-optional-request-property
- ○
- ○
endpoint added
endpoint-added
- ○