Skip to main content
Messages API enables search through a versioned server tool entry in tools[]. Use this when you need Anthropic-compatible request format and only a minimal public search tool shape.

Request Shape

The supported public shape on this endpoint is:
Use it in a normal request like this:

What This Surface Supports

On Messages, the public request schema only accepts the minimal versioned tool identifier. It does not expose richer search configuration on this endpoint. If you need a configurable search object with filters or user location, use:

Common mistakes

  • trying to pass web_search_options or Responses-style search tools on this surface
  • expecting filters or location controls in the public Messages request shape
  • using Messages search for new work when Responses would be the simpler teaching path

Caveats

  • the currently documented version here is web_search_20250305
  • this surface is for Anthropic protocol compatibility, not the primary search teaching path
  • search configuration is intentionally narrower here than on Responses or Chat Completions