feat(api): api update (#2121)

stainless-app[bot] · meorphis · commit c34e30a31c44 · 2025-01-13T10:21:12.000-05:00
diff --git a/.stats.yml b/.stats.yml
@@ -1,2 +1,2 @@
 configured_endpoints: 1365
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-4593529df2c582c5e4de92308af748d9f8abbca6c92fff7e99e08bd463b7271e.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-eafbd03fd73e3a55e352ee0c79c070b09d59559f24c33911a864654a501c778f.yml
diff --git a/src/resources/brand-protection.ts b/src/resources/brand-protection.ts
@@ -18,7 +18,7 @@ export class BrandProtection extends APIResource {
   }
 
   /**
-   * Get results for a URL scan
+   * Gets phishing details about a URL.
    */
   urlInfo(params: BrandProtectionURLInfoParams, options?: Core.RequestOptions): Core.APIPromise<Info> {
     const { account_id, ...query } = params;
diff --git a/src/resources/intel/asn/asn.ts b/src/resources/intel/asn/asn.ts
@@ -10,7 +10,8 @@ export class ASN extends APIResource {
   subnets: SubnetsAPI.Subnets = new SubnetsAPI.Subnets(this._client);
 
   /**
-   * Get ASN Overview
+   * Gets an overview of the Autonomous System Number (ASN) and a list of subnets for
+   * it.
    */
   get(
     asn: Shared.ASNParam,
diff --git a/src/resources/intel/dns.ts b/src/resources/intel/dns.ts
@@ -7,7 +7,7 @@ import { V4PagePagination, type V4PagePaginationParams } from '../../pagination'
 
 export class DNS extends APIResource {
   /**
-   * Get Passive DNS by IP
+   * Gets a list of all the domains that have resolved to a specific IP address.
    */
   list(
     params: DNSListParams,
diff --git a/src/resources/intel/domain-history.ts b/src/resources/intel/domain-history.ts
@@ -5,7 +5,8 @@ import * as Core from '../../core';
 
 export class DomainHistoryResource extends APIResource {
   /**
-   * Get Domain History
+   * Gets historical security threat and content categories currently and previously
+   * assigned to a domain.
    */
   get(
     params: DomainHistoryGetParams,
diff --git a/src/resources/intel/domains/domains.ts b/src/resources/intel/domains/domains.ts
@@ -9,7 +9,7 @@ export class Domains extends APIResource {
   bulks: BulksAPI.Bulks = new BulksAPI.Bulks(this._client);
 
   /**
-   * Get Domain Details
+   * Gets security details and statistics about a domain.
    */
   get(params: DomainGetParams, options?: Core.RequestOptions): Core.APIPromise<Domain> {
     const { account_id, ...query } = params;
diff --git a/src/resources/intel/ips.ts b/src/resources/intel/ips.ts
@@ -5,7 +5,8 @@ import * as Core from '../../core';
 
 export class IPs extends APIResource {
   /**
-   * Same as summary
+   * Gets the geolocation, ASN, infrastructure type of the ASN, and any security
+   * threat categories of an IP address.
    */
   get(params: IPGetParams, options?: Core.RequestOptions): Core.APIPromise<IPGetResponse | null> {
     const { account_id, ...query } = params;
diff --git a/src/resources/intel/miscategorizations.ts b/src/resources/intel/miscategorizations.ts
@@ -6,7 +6,7 @@ import * as Shared from '../shared';
 
 export class Miscategorizations extends APIResource {
   /**
-   * Create Miscategorization
+   * Allows you to submit requests to change a domain’s category.
    */
   create(
     params: MiscategorizationCreateParams,

Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,2 @@`
`1`	`1`	`configured_endpoints: 1365`
`2`		`-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-4593529df2c582c5e4de92308af748d9f8abbca6c92fff7e99e08bd463b7271e.yml`
	`2`	`+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-eafbd03fd73e3a55e352ee0c79c070b09d59559f24c33911a864654a501c778f.yml`
Original file line number	Diff line number	Diff line change
`@@ -18,7 +18,7 @@ export class BrandProtection extends APIResource {`
`18`	`18`	`}`
`19`	`19`
`20`	`20`	`/**`
`21`		`- * Get results for a URL scan`
	`21`	`+ * Gets phishing details about a URL.`
`22`	`22`	`*/`
`23`	`23`	`urlInfo(params: BrandProtectionURLInfoParams, options?: Core.RequestOptions): Core.APIPromise<Info> {`
`24`	`24`	`const { account_id, ...query } = params;`