---
title: "Search tools"
method: POST
path: "/tools/search"
tags: ["gateway"]
---

# Search tools

`POST /tools/search`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/tools/search`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Search for external tool actions.

## Request body

- object
  - `queries` object[]
    - `use_case` string, required: Natural-language use case.
    - `known_fields` string
  - `query` string
  - `toolkit` string
  - `toolkit_slug` string
  - `limit` integer
  - `important` boolean
  - `session` object
    - `id` string
    - `generate_id` boolean
  - `account` string
  - `model` string

## Response `200`

Successful response

- object: Tool search response with gateway enrichments.
  - `success` boolean
  - `error` string, nullable
  - `results` object[]
    - `use_case` string, required
    - `primary_tool_slugs` string[]
    - `related_tool_slugs` string[]
    - `toolkits` string[]
    - `execution_guidance` string
    - `recommended_plan_steps` string[]
    - `known_pitfalls` string[]
  - `toolkit_connection_statuses` object[]
    - `toolkit` string, required
    - `has_active_connection` boolean, required
    - `status_message` string, nullable
    - `accounts` object[]
  - `tool_schemas` object: Tool slug -> schema with gateway-added execution_ref for tool.run.
  - `session` object: Tool-router session; reuse session.id for follow-up calls.
    - `id` string, required
  - `items` object[]
  - `nativeAvailable` boolean
  - `available` boolean
  - `execution_ref_version` number

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)