Skip to main content
POST
/
api
/
v1
/
tool-packs
/
{tool_pack_id}
/
registered-users
/
{registered_user_id}
/
search
Search Tools
curl --request POST \
  --url https://ah-api.merge.dev/api/v1/tool-packs/{tool_pack_id}/registered-users/{registered_user_id}/search \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "intent": "I need to create a new ticket in our project management system",
  "connector_ids": [
    "134e0111-0f67-44f6-98f0-597000290bb3"
  ],
  "max_results": 10
}'
{
  "tools": [
    {
      "tool_name": "create_issue",
      "connector_slug": "linear",
      "description": "Create a new issue in Linear",
      "input_schema": {
        "type": "object",
        "required": [
          "input"
        ],
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "teamId": {
                "type": "string"
              }
            }
          }
        }
      },
      "relevance_score": 1,
      "reasoning": "The 'create_issue' tool directly matches the user's intent to create a new ticket in Linear."
    }
  ],
  "total_results": 1,
  "intent": "I need to create a new ticket in Linear"
}

Authorizations

Authorization
string
header
required

Production Access Key (Bearer)

Path Parameters

tool_pack_id
string<uuid>
required

Agent Handler ID of the Tool Pack

registered_user_id
string<uuid>
required

Agent Handler ID of the Registered User

Body

intent
string
required

User's intent or what they want to accomplish

Example:

"I need to create a new ticket in our project management system"

connector_ids
string<uuid>[]

Optional list of connector IDs to filter the search

Example:
["134e0111-0f67-44f6-98f0-597000290bb3"]
max_results
integer
default:10

Maximum number of results to return

Example:

10

Response

200 - application/json
tools
object[]
required

List of tools matching the search intent

total_results
integer
required

Total number of tools returned

Example:

1

intent
string
required

The original search intent provided by the user

Example:

"I need to create a new ticket in Linear"