---
title: "Execute the Bee Code web_search tool"
method: POST
path: "/bee/code/v1/search"
---

# Execute the Bee Code web_search tool

`POST /bee/code/v1/search`

## Request

- Base URL: `https://api.bee.heossi.com`
- URL: `https://api.bee.heossi.com/bee/code/v1/search`
- Auth: HTTP bearer

Registry-driven live web search for the bee.code.v1 agent plane. The client executes the model's web_search tool call by POSTing here with its turn credential.

## Request body

- object
  - `query` string, required
  - `count` integer

## Response `200`

Provider used and titled results with URLs and snippets

## Other responses

- `400`: Missing or invalid query
- `401`: Missing or invalid API credential
- `502`: Every configured search provider failed
- `503`: No search provider configured on this deployment

---

[API](https://skmtc.dev/heossi/apis/bee-quantum-intelligence-developer-api.md) · [All operations](https://skmtc.dev/heossi/apis/bee-quantum-intelligence-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heossi/apis/bee-quantum-intelligence-developer-api/revisions/285f9cfc359b?raw)