---
title: "Search tools (Admin UI)"
url: "/docs/proxy/ui_search_tools"
canonical_url: "https://docs.litellm.ai/docs/proxy/ui_search_tools"
type: "docs"
last_updated: "2026-10-09"
summary: "Control which teams and virtual keys may call each configured web search integration (/v1/search) and see team/key level usage visibility within LiteLLM's spend dashboard."
related:
  - "/docs/proxy/ui_project_management"
  - "/docs/proxy/ui/bulk_edit_users"
---
# Search tools (Admin UI)

> Index of all LiteLLM docs: https://docs.litellm.ai/llms.txt


Control which teams and virtual keys may call each configured web search integration (`/v1/search`) and see team/key level usage visibility within LiteLLM's spend dashboard.

![](/img/ui-search-tools/step-01-go-to-search-tools-tab.png)

## Step 1: Register tools

**Search tools** page → create tool (name + provider + credentials).

![](/img/ui-search-tools/step-02-add-new-search-tool.png)

## Step 2: Team allowlist

**Teams** → create/edit team → open **Search Tool Settings** → add tool(s) to the team.

![](/img/ui-search-tools/step-03-create-or-edit-team.png)
![](/img/ui-search-tools/step-04-open-search-tool-settings.png)
![](/img/ui-search-tools/step-05-add-search-tool-to-team.png)

## Step 3: Key (optional stricter list)

**Virtual keys** → generate/update for that team → **Search Tool Settings** must stay inside the team list (if team list is non-empty).

![](/img/ui-search-tools/step-06-create-team-key.png)

## Step 4: Call search

```bash
curl -sS -X POST "http://localhost:4000/v1/search/YOUR_SEARCH_TOOL_NAME" \
  -H "Authorization: Bearer YOUR_VIRTUAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "hello world", "max_results": 5}'
```

![](/img/ui-search-tools/step-07-open-usage-team-usage.png)

## Step 5: See spend

**Logs** → filter **Team ID** + **Public model / search tool** = `search_tool_name` → **Cost** column.

![](/img/ui-search-tools/step-08-select-team.png)
![](/img/ui-search-tools/step-09-see-search-tool-usage.png)

## Related

- [Search providers & YAML](../search/index.md)
- [Proxy config (`search_tools` row)](./config_settings.md)

## Related pages

- [[Beta] Project Management UI](https://docs.litellm.ai/docs/proxy/ui_project_management.md)
- [Bulk Edit Users](https://docs.litellm.ai/docs/proxy/ui/bulk_edit_users.md)