Web Search tool

Use Web Search when you need the assistant to run a quick web query and return results.

Prerequisites

An API token. See Backoffice Developer Console.

Requirements

Tool spec: { "name": "web_search", "type": "web_search_v1" }
No tool_context required

Basic request and response

This example validates a request that enables the web search tool:

curl -X POST "https://{BASE_URL}/api/gpt/v1/messages/validate" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "default",
    "max_tokens": 64,
    "messages": [
      { "role": "user", "content": "Find recent updates about the EU AI Act." }
    ],
    "tools": [
      { "name": "web_search", "type": "web_search_v1" }
    ],
    "tool_choice": { "type": "auto" }
  }'

Example response:

{ "valid": true, "errors": null }

To run the request, send the same body to POST /messages.

Tips

Use a focused query to reduce noisy results.
Combine with a system prompt to control summarization style.

Next steps

Learn how messages return tool blocks: Messages

​Prerequisites

​Requirements

​Basic request and response

​Tips

​Next steps

Prerequisites

Requirements

Basic request and response

Tips

Next steps