feat(api): api update (#3886)

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 1525
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-bc3696a18f538851d12e180969b9827d32e3008d0e966fe42219261d88f22b01.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-ac150b149275b115601462ffcfbcb02a9c2f2809b04cb9a5bd9bfb9d1bd100f0.yml

url_scanner/response.go

@@ -32,8 +32,8 @@ func NewResponseService(opts ...option.RequestOption) (r *ResponseService) {
 	return
 }
 
-// Returns the raw response of the network request. If HTML, a plain text response
-// will be returned.
+// Returns the raw response of the network request. Find the `response_id` in the
+// `data.requests.response.hash`.
 func (r *ResponseService) Get(ctx context.Context, responseID string, query ResponseGetParams, opts ...option.RequestOption) (res *string, err error) {
 	opts = append(r.Options[:], opts...)
 	opts = append([]option.RequestOption{option.WithHeader("Accept", "text/plain")}, opts...)

url_scanner/scan.go

@@ -54,13 +54,13 @@ func (r *ScanService) New(ctx context.Context, params ScanNewParams, opts ...opt
 }
 
 // Use a subset of ElasticSearch Query syntax to filter scans. Some example
-// queries:<br/> <br/>- 'page.domain:microsoft AND verdicts.malicious:true AND NOT
+// queries:<br/> <br/>- 'path:"/bundles/jquery.js"': Searches for scans who
+// requested resources with the given path.<br/>- 'page.asn:AS24940 AND hash:xxx':
+// Websites hosted in AS24940 where a resource with the given hash was
+// downloaded.<br/>- 'page.domain:microsoft\* AND verdicts.malicious:true AND NOT
 // page.domain:microsoft.com': malicious scans whose hostname starts with
-// "microsoft".<br/>- 'apikey:me AND date:[2024-01 TO 2024-10]': my scans from 2024
-// January to 2024 October.<br/>- 'page.domain:(blogspot OR www.blogspot)':
-// Searches for scans whose main domain starts with "blogspot" or with
-// "www.blogspot"<br/>- 'page.asn:AS24940 AND hash:xxx': Websites hosted in AS24940
-// where a resource with the given hash was downloaded.
+// "microsoft".<br/>- 'apikey:me AND date:[2025-01 TO 2025-02]': my scans from 2025
+// January to 2025 February.
 func (r *ScanService) List(ctx context.Context, params ScanListParams, opts ...option.RequestOption) (res *ScanListResponse, err error) {
 	opts = append(r.Options[:], opts...)
 	if params.AccountID.Value == "" {