Skip to main content
POST
/
tools
/
search
Search tools
curl --request POST \
  --url https://www.dench.com/api/v1/tools/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "queries": [
    {
      "use_case": "fetch the 10 most recent emails"
    }
  ]
}
'
{
  "success": true,
  "error": null,
  "results": [
    {
      "use_case": "fetch recent emails",
      "primary_tool_slugs": [
        "GMAIL_FETCH_EMAILS"
      ],
      "toolkits": [
        "gmail"
      ]
    }
  ],
  "toolkit_connection_statuses": [
    {
      "toolkit": "gmail",
      "has_active_connection": true
    }
  ],
  "tool_schemas": {
    "GMAIL_FETCH_EMAILS": {
      "toolkit": "gmail",
      "tool_slug": "GMAIL_FETCH_EMAILS",
      "execution_ref": "eyJzZXNzaW9uIjoi...",
      "execution_ref_version": 1
    }
  },
  "session": {
    "id": "trs_abc123",
    "generate_id": true
  },
  "execution_ref_version": 1
}

Authorizations

Authorization
string
header
required

Workspace-scoped Dench API key from workspace settings. This is the same key used by DENCH_API_KEY in sandboxes.

Body

application/json
queries
object[]
required
Required array length: 1 - 7 elements
session
object
account
string
model
string

Response

Successful response

Composio tool-router search response with gateway enrichments.

session
object
required

Tool-router session; reuse session.id for follow-up calls.

success
boolean
error
string | null
results
object[]
toolkit_connection_statuses
object[]
tool_schemas
object

Tool slug -> schema with gateway-added execution_ref for tool.run.

execution_ref_version
number
{key}
any