@censys/platform-sdk 0.4.3 → 0.5.0

package/src/sdk/globaldata.ts

@@ -3,11 +3,15 @@
  */
 
 import { globalDataAggregate } from "../funcs/globalDataAggregate.js";
+import { globalDataCreateTrackedScan } from "../funcs/globalDataCreateTrackedScan.js";
 import { globalDataGetCertificate } from "../funcs/globalDataGetCertificate.js";
 import { globalDataGetCertificates } from "../funcs/globalDataGetCertificates.js";
 import { globalDataGetHost } from "../funcs/globalDataGetHost.js";
+import { globalDataGetHostObservationsWithCertificate } from "../funcs/globalDataGetHostObservationsWithCertificate.js";
 import { globalDataGetHosts } from "../funcs/globalDataGetHosts.js";
 import { globalDataGetHostTimeline } from "../funcs/globalDataGetHostTimeline.js";
+import { globalDataGetTrackedScan } from "../funcs/globalDataGetTrackedScan.js";
+import { globalDataGetTrackedScanThreatHunting } from "../funcs/globalDataGetTrackedScanThreatHunting.js";
 import { globalDataGetWebProperties } from "../funcs/globalDataGetWebProperties.js";
 import { globalDataGetWebProperty } from "../funcs/globalDataGetWebProperty.js";
 import { globalDataSearch } from "../funcs/globalDataSearch.js";
@@ -50,6 +54,25 @@ export class GlobalData extends ClientSDK {
     ));
   }
 
+  /**
+   * Get Host Observations With Certificate
+   *
+   * @remarks
+   * Retrieve historical observations of hosts associated with a certificate fingerprint. Useful for threat hunting, detection engineering, and timeline generation.
+   */
+  async getHostObservationsWithCertificate(
+    request: operations.V3GlobaldataGetHostObservationsWithCertificateRequest,
+    options?: RequestOptions,
+  ): Promise<
+    operations.V3GlobaldataGetHostObservationsWithCertificateResponse
+  > {
+    return unwrapAsync(globalDataGetHostObservationsWithCertificate(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Get multiple hosts
    *
@@ -135,6 +158,41 @@ export class GlobalData extends ClientSDK {
     ));
   }
 
+  /**
+   * Create a tracked rescan
+   *
+   * @remarks
+   * Create a new tracked rescan for a known service or web property. Rescans are used to update information for previously discovered targets. The scan will be queued. The response will contain a scan ID that you can use with the [get tracked scan details endpoint](https://docs.censys.com/reference/v3-globaldata-scans-get#/) to monitor its status and results.<br><br>This endpoint is available to all Enterprise customers.
+   */
+  async createTrackedScan(
+    request: operations.V3GlobaldataScansRescanRequest,
+    options?: RequestOptions,
+  ): Promise<operations.V3GlobaldataScansRescanResponse> {
+    return unwrapAsync(globalDataCreateTrackedScan(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get tracked scan details
+   *
+   * @remarks
+   * Retrieve the current status and results of a tracked scan by its ID.
+   *         This endpoint works for both discovery scans and rescans.
+   */
+  async getTrackedScan(
+    request: operations.V3GlobaldataScansGetRequest,
+    options?: RequestOptions,
+  ): Promise<operations.V3GlobaldataScansGetResponse> {
+    return unwrapAsync(globalDataGetTrackedScan(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Aggregate results for a search query
    *
@@ -168,4 +226,22 @@ export class GlobalData extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * Get tracked scan details
+   *
+   * @remarks
+   * Retrieve the current status and results of a tracked scan by its ID.
+   *         This endpoint works for both discovery scans and rescans.
+   */
+  async getTrackedScanThreatHunting(
+    request: operations.V3ThreathuntingScansGetRequest,
+    options?: RequestOptions,
+  ): Promise<operations.V3ThreathuntingScansGetResponse> {
+    return unwrapAsync(globalDataGetTrackedScanThreatHunting(
+      this,
+      request,
+      options,
+    ));
+  }
 }

package/src/sdk/threathunting.ts

@@ -2,12 +2,68 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import { globalDataGetTrackedScan } from "../funcs/globalDataGetTrackedScan.js";
+import { globalDataGetTrackedScanThreatHunting } from "../funcs/globalDataGetTrackedScanThreatHunting.js";
+import { threatHuntingCreateTrackedScan } from "../funcs/threatHuntingCreateTrackedScan.js";
 import { threatHuntingValueCounts } from "../funcs/threatHuntingValueCounts.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
 export class ThreatHunting extends ClientSDK {
+  /**
+   * Get tracked scan details
+   *
+   * @remarks
+   * Retrieve the current status and results of a tracked scan by its ID.
+   *         This endpoint works for both discovery scans and rescans.
+   */
+  async getTrackedScan(
+    request: operations.V3GlobaldataScansGetRequest,
+    options?: RequestOptions,
+  ): Promise<operations.V3GlobaldataScansGetResponse> {
+    return unwrapAsync(globalDataGetTrackedScan(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Create a tracked discovery scan
+   *
+   * @remarks
+   * Create a new tracked discovery scan for a specified target. Discovery scans are used to scan new targets that have not been previously identified. The scan will be queued. The response will contain a scan ID that you can use with the [get tracked scan details endpoint](https://docs.censys.com/reference/v3-globaldata-scans-get#/) to monitor its status and results.<br><br>This endpoint is available to organizations that have access to the Threat Hunting module.
+   */
+  async createTrackedScan(
+    request: operations.V3ThreathuntingScansDiscoveryRequest,
+    options?: RequestOptions,
+  ): Promise<operations.V3ThreathuntingScansDiscoveryResponse> {
+    return unwrapAsync(threatHuntingCreateTrackedScan(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get tracked scan details
+   *
+   * @remarks
+   * Retrieve the current status and results of a tracked scan by its ID.
+   *         This endpoint works for both discovery scans and rescans.
+   */
+  async getTrackedScanThreatHunting(
+    request: operations.V3ThreathuntingScansGetRequest,
+    options?: RequestOptions,
+  ): Promise<operations.V3ThreathuntingScansGetResponse> {
+    return unwrapAsync(globalDataGetTrackedScanThreatHunting(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * CensEye: Retrieve value counts to discover pivots
    *