Beta Managed Agents Web Search Tool Config Params

• BetaManagedAgentsWebSearchToolConfigParams object

  Configuration override for the web_search tool.

  • type: optional "web_search"

  • name: "web_search"

    Must be "web_search".

  • allowed_domains: optional array of string

    Only return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains.

  • blocked_domains: optional array of string

    Never return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains.

  • enabled: optional boolean or null

    Whether this tool is enabled and available to Claude. Overrides the default_config setting.

  • permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null

    Permission policy for tool execution.

    • BetaManagedAgentsAlwaysAllowPolicy object

      Tool calls are automatically approved without user confirmation.

      • type: "always_allow"

    • BetaManagedAgentsAlwaysAskPolicy object

      Tool calls require user confirmation before execution.

      • type: "always_ask"

    • BetaManagedAgentsAutoPolicy object

      The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.

      • type: "auto"

  • user_location: optional BetaManagedAgentsUserLocation or null

    Approximate user location for search result localization.

    • type: "approximate"

      Location precision. Only "approximate" is supported.

    • city: optional string or null

      City name.

      minLength: 1, maxLength: 255

    • country: optional string or null

      Two-letter ISO 3166-1 country code, uppercase.

    • region: optional string or null

      Region or state name.

      minLength: 1, maxLength: 255

    • timezone: optional string or null

      IANA timezone identifier, e.g. "America/Los_Angeles".

      minLength: 1, maxLength: 255