@censys/platform-sdk 0.12.12 → 0.12.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (142) hide show
  1. package/docs/sdks/adversaryinvestigation/README.md +8 -8
  2. package/docs/sdks/collections/README.md +5 -5
  3. package/docs/sdks/globaldata/README.md +19 -19
  4. package/docs/sdks/tagsandcomments/README.md +1 -1
  5. package/docs/sdks/threathunting/README.md +9 -9
  6. package/funcs/collectionsAggregate.d.ts +1 -1
  7. package/funcs/collectionsAggregate.js +1 -1
  8. package/funcs/collectionsCreate.d.ts +1 -1
  9. package/funcs/collectionsCreate.js +1 -1
  10. package/funcs/collectionsGet.d.ts +1 -1
  11. package/funcs/collectionsGet.js +1 -1
  12. package/funcs/collectionsListEvents.d.ts +1 -1
  13. package/funcs/collectionsListEvents.js +1 -1
  14. package/funcs/collectionsSearch.d.ts +1 -1
  15. package/funcs/collectionsSearch.js +1 -1
  16. package/funcs/globalDataAggregate.d.ts +1 -1
  17. package/funcs/globalDataAggregate.js +1 -1
  18. package/funcs/globalDataCreateTrackedScan.d.ts +1 -1
  19. package/funcs/globalDataCreateTrackedScan.js +1 -1
  20. package/funcs/globalDataGetCertificate.d.ts +1 -1
  21. package/funcs/globalDataGetCertificate.js +1 -1
  22. package/funcs/globalDataGetCertificateRaw.d.ts +1 -1
  23. package/funcs/globalDataGetCertificateRaw.js +1 -1
  24. package/funcs/globalDataGetCertificates.d.ts +1 -1
  25. package/funcs/globalDataGetCertificates.js +1 -1
  26. package/funcs/globalDataGetCertificatesRaw.d.ts +1 -1
  27. package/funcs/globalDataGetCertificatesRaw.js +1 -1
  28. package/funcs/globalDataGetHost.d.ts +1 -1
  29. package/funcs/globalDataGetHost.js +1 -1
  30. package/funcs/globalDataGetHostEnrichment.d.ts +1 -1
  31. package/funcs/globalDataGetHostEnrichment.js +1 -1
  32. package/funcs/globalDataGetHostTimeline.d.ts +1 -1
  33. package/funcs/globalDataGetHostTimeline.js +1 -1
  34. package/funcs/globalDataGetHosts.d.ts +1 -1
  35. package/funcs/globalDataGetHosts.js +1 -1
  36. package/funcs/globalDataGetTrackedScan.d.ts +1 -1
  37. package/funcs/globalDataGetTrackedScan.js +1 -1
  38. package/funcs/globalDataGetWebProperties.d.ts +1 -1
  39. package/funcs/globalDataGetWebProperties.js +1 -1
  40. package/funcs/globalDataGetWebProperty.d.ts +1 -1
  41. package/funcs/globalDataGetWebProperty.js +1 -1
  42. package/funcs/globalDataListDnsIpResolutionBounds.d.ts +1 -1
  43. package/funcs/globalDataListDnsIpResolutionBounds.js +1 -1
  44. package/funcs/globalDataListDnsIpResolutionRanges.d.ts +1 -1
  45. package/funcs/globalDataListDnsIpResolutionRanges.js +1 -1
  46. package/funcs/globalDataListDnsNameResolutionBounds.d.ts +1 -1
  47. package/funcs/globalDataListDnsNameResolutionBounds.js +1 -1
  48. package/funcs/globalDataListDnsNameResolutionRanges.d.ts +1 -1
  49. package/funcs/globalDataListDnsNameResolutionRanges.js +1 -1
  50. package/funcs/globalDataListServicesOnHost.d.ts +1 -1
  51. package/funcs/globalDataListServicesOnHost.js +1 -1
  52. package/funcs/globalDataSearch.d.ts +1 -1
  53. package/funcs/globalDataSearch.js +1 -1
  54. package/funcs/tagsAndCommentsUpdateTag.d.ts +1 -1
  55. package/funcs/tagsAndCommentsUpdateTag.js +1 -1
  56. package/funcs/threatHuntingCreateCenseyeJob.d.ts +1 -1
  57. package/funcs/threatHuntingCreateCenseyeJob.js +1 -1
  58. package/funcs/threatHuntingCreateInvestigationFileUpload.d.ts +1 -1
  59. package/funcs/threatHuntingCreateInvestigationFileUpload.js +1 -1
  60. package/funcs/threatHuntingCreateInvestigationJob.d.ts +1 -1
  61. package/funcs/threatHuntingCreateInvestigationJob.js +1 -1
  62. package/funcs/threatHuntingCreateTrackedScan.d.ts +1 -1
  63. package/funcs/threatHuntingCreateTrackedScan.js +1 -1
  64. package/funcs/threatHuntingGetCenseyeJobResults.d.ts +1 -1
  65. package/funcs/threatHuntingGetCenseyeJobResults.js +1 -1
  66. package/funcs/threatHuntingGetHostObservationsWithCertificate.d.ts +1 -1
  67. package/funcs/threatHuntingGetHostObservationsWithCertificate.js +1 -1
  68. package/funcs/threatHuntingGetTrackedScanThreatHunting.d.ts +1 -1
  69. package/funcs/threatHuntingGetTrackedScanThreatHunting.js +1 -1
  70. package/funcs/threatHuntingListThreats.d.ts +1 -1
  71. package/funcs/threatHuntingListThreats.js +1 -1
  72. package/funcs/threatHuntingValueCounts.d.ts +1 -1
  73. package/funcs/threatHuntingValueCounts.js +1 -1
  74. package/jsr.json +1 -1
  75. package/lib/config.d.ts +4 -4
  76. package/lib/config.js +4 -4
  77. package/models/components/http.d.ts +6 -0
  78. package/models/components/http.d.ts.map +1 -1
  79. package/models/components/http.js +4 -0
  80. package/models/components/http.js.map +1 -1
  81. package/models/components/httpcopyright.d.ts +17 -0
  82. package/models/components/httpcopyright.d.ts.map +1 -0
  83. package/models/components/httpcopyright.js +51 -0
  84. package/models/components/httpcopyright.js.map +1 -0
  85. package/models/components/index.d.ts +1 -0
  86. package/models/components/index.d.ts.map +1 -1
  87. package/models/components/index.js +1 -0
  88. package/models/components/index.js.map +1 -1
  89. package/package.json +1 -1
  90. package/sdk/adversaryinvestigation.d.ts +8 -8
  91. package/sdk/adversaryinvestigation.js +8 -8
  92. package/sdk/collections.d.ts +5 -5
  93. package/sdk/collections.js +5 -5
  94. package/sdk/globaldata.d.ts +19 -19
  95. package/sdk/globaldata.js +19 -19
  96. package/sdk/tagsandcomments.d.ts +1 -1
  97. package/sdk/tagsandcomments.js +1 -1
  98. package/sdk/threathunting.d.ts +9 -9
  99. package/sdk/threathunting.js +9 -9
  100. package/src/funcs/collectionsAggregate.ts +1 -1
  101. package/src/funcs/collectionsCreate.ts +1 -1
  102. package/src/funcs/collectionsGet.ts +1 -1
  103. package/src/funcs/collectionsListEvents.ts +1 -1
  104. package/src/funcs/collectionsSearch.ts +1 -1
  105. package/src/funcs/globalDataAggregate.ts +1 -1
  106. package/src/funcs/globalDataCreateTrackedScan.ts +1 -1
  107. package/src/funcs/globalDataGetCertificate.ts +1 -1
  108. package/src/funcs/globalDataGetCertificateRaw.ts +1 -1
  109. package/src/funcs/globalDataGetCertificates.ts +1 -1
  110. package/src/funcs/globalDataGetCertificatesRaw.ts +1 -1
  111. package/src/funcs/globalDataGetHost.ts +1 -1
  112. package/src/funcs/globalDataGetHostEnrichment.ts +1 -1
  113. package/src/funcs/globalDataGetHostTimeline.ts +1 -1
  114. package/src/funcs/globalDataGetHosts.ts +1 -1
  115. package/src/funcs/globalDataGetTrackedScan.ts +1 -1
  116. package/src/funcs/globalDataGetWebProperties.ts +1 -1
  117. package/src/funcs/globalDataGetWebProperty.ts +1 -1
  118. package/src/funcs/globalDataListDnsIpResolutionBounds.ts +1 -1
  119. package/src/funcs/globalDataListDnsIpResolutionRanges.ts +1 -1
  120. package/src/funcs/globalDataListDnsNameResolutionBounds.ts +1 -1
  121. package/src/funcs/globalDataListDnsNameResolutionRanges.ts +1 -1
  122. package/src/funcs/globalDataListServicesOnHost.ts +1 -1
  123. package/src/funcs/globalDataSearch.ts +1 -1
  124. package/src/funcs/tagsAndCommentsUpdateTag.ts +1 -1
  125. package/src/funcs/threatHuntingCreateCenseyeJob.ts +1 -1
  126. package/src/funcs/threatHuntingCreateInvestigationFileUpload.ts +1 -1
  127. package/src/funcs/threatHuntingCreateInvestigationJob.ts +1 -1
  128. package/src/funcs/threatHuntingCreateTrackedScan.ts +1 -1
  129. package/src/funcs/threatHuntingGetCenseyeJobResults.ts +1 -1
  130. package/src/funcs/threatHuntingGetHostObservationsWithCertificate.ts +1 -1
  131. package/src/funcs/threatHuntingGetTrackedScanThreatHunting.ts +1 -1
  132. package/src/funcs/threatHuntingListThreats.ts +1 -1
  133. package/src/funcs/threatHuntingValueCounts.ts +1 -1
  134. package/src/lib/config.ts +4 -4
  135. package/src/models/components/http.ts +9 -0
  136. package/src/models/components/httpcopyright.ts +39 -0
  137. package/src/models/components/index.ts +1 -0
  138. package/src/sdk/adversaryinvestigation.ts +8 -8
  139. package/src/sdk/collections.ts +5 -5
  140. package/src/sdk/globaldata.ts +19 -19
  141. package/src/sdk/tagsandcomments.ts +1 -1
  142. package/src/sdk/threathunting.ts +9 -9
@@ -22,7 +22,7 @@ Endpoints related to the Adversary Investigation product
22
22
 
23
23
  ## createCenseyeJob
24
24
 
25
- Create an asynchronous CensEye pivot analysis job for a host, web property, or certificate. The job extracts [default pivot fields](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#default-pivot-fields) from the target asset and counts matching documents for each field-value pair. Poll the job status endpoint to track progress, then retrieve results when complete.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint costs 44 credits to execute for a host, 28 credits to execute for a web property, and 7 credits to execute for a certificate.
25
+ Create an asynchronous CensEye pivot analysis job for a host, web property, or certificate. The job extracts [default pivot fields](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#default-pivot-fields) from the target asset and counts matching documents for each field-value pair. Poll the job status endpoint to track progress, then retrieve results when complete.<br><br>Use this endpoint to start an analysis of a suspicious host, web property, or certificate that finds the rare attributes it shares with other assets, so you can uncover related attacker infrastructure.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint costs 44 credits to execute for a host, 28 credits to execute for a web property, and 7 credits to execute for a certificate.
26
26
 
27
27
  ### Example Usage
28
28
 
@@ -190,7 +190,7 @@ run();
190
190
 
191
191
  ## getCenseyeJobResults
192
192
 
193
- Retrieve the results of a completed CensEye pivot analysis job. Each result contains a count and the field-value pairs that were analyzed. Results may be empty if the job is still running.<br><br>Results are paginated. Use the `next_page_token` from the response to fetch subsequent pages.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.
193
+ Retrieve the results of a completed CensEye pivot analysis job. Use this endpoint to retrieve the pivots from a finished job, then turn the most distinctive ones into searches or blocklist candidates.<br><br>Each result contains a count and the field-value pairs that were analyzed. Results may be empty if the job is still running.<br><br>Results are paginated. Use the `next_page_token` from the response to fetch subsequent pages.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.
194
194
 
195
195
  ### Example Usage
196
196
 
@@ -268,7 +268,7 @@ run();
268
268
 
269
269
  ## getHostObservationsWithCertificate
270
270
 
271
- Retrieve the historical observations of hosts associated with a certificate. This is useful for threat hunting, detection engineering, and timeline generation. Certificate history is also visible to Adversary Investigation users in the Platform UI on the [certificate timeline](https://docs.censys.com/docs/platform-threat-hunting-use-cert-history-to-build-better-detections#/).<br><br>You can define a specific time frame of interest. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account.<br><br>For workspaces with a history limit, the API returns observation ranges that overlap the allowed history window. The window starts at 00:00 UTC the allowed number of days ago and ends at the time of the request. Ranges are returned in full, with their original start and end times, even if they extend outside the window.<br><br>You may also filter results by port and transport protocol.<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module. This endpoint costs one credit per page of results.
271
+ Retrieve the historical observations of hosts associated with a certificate. Use this endpoint to see every host that has presented a given certificate over time, so you can build a timeline and find other infrastructure using it.<br><br>Certificate history is also visible to Adversary Investigation users in the Platform UI on the [certificate timeline](https://docs.censys.com/docs/platform-threat-hunting-use-cert-history-to-build-better-detections#/).<br><br>You can define a specific time frame of interest. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account.<br><br>For workspaces with a history limit, the API returns observation ranges that overlap the allowed history window. The window starts at 00:00 UTC the allowed number of days ago and ends at the time of the request. Ranges are returned in full, with their original start and end times, even if they extend outside the window.<br><br>You may also filter results by port and transport protocol.<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module. This endpoint costs one credit per page of results.
272
272
 
273
273
  ### Example Usage
274
274
 
@@ -356,7 +356,7 @@ run();
356
356
 
357
357
  ## createInvestigationFileUpload
358
358
 
359
- Prepare to attach an evidence file to an investigation. This endpoint does not accept the file. It returns a URL to send the file to and an identifier to pass to the [create job endpoint](https://docs.censys.com/reference/v3-threathunting-investigations-jobs-create) afterwards.<br><br>Upload the file with an HTTP PUT to `upload_url` and send `upload_headers` exactly as returned by this endpoint. The URL grants access to that one file and stops working at `expire_time`; a file uploaded before that stays usable afterwards. Prepare one upload per file.<br><br>Start the investigation promptly after uploading. There is a limit on how many uploaded files you may hold without using them and starting an investigation from a file releases its slot. A file that no investigation references is discarded once it passes the service's retention window for unused uploads. A file an investigation does reference is kept with that investigation for as long as the investigation itself.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint does not cost any credits to execute.
359
+ Prepare to attach an evidence file to an investigation. Use this endpoint to stage evidence, such as logs, malware reports, or alert exports, so an AI investigation can use it.<br><br>This endpoint does not accept the file. It returns a URL to send the file to and an identifier to pass to the [create job endpoint](https://docs.censys.com/reference/v3-threathunting-investigations-jobs-create) afterwards.<br><br>Upload the file with an HTTP PUT to `upload_url` and send `upload_headers` exactly as returned by this endpoint. The URL grants access to that one file and stops working at `expire_time`; a file uploaded before that stays usable afterwards. Prepare one upload per file.<br><br>Start the investigation promptly after uploading. There is a limit on how many uploaded files you may hold without using them and starting an investigation from a file releases its slot. A file that no investigation references is discarded once it passes the service's retention window for unused uploads. A file an investigation does reference is kept with that investigation for as long as the investigation itself.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint does not cost any credits to execute.
360
360
 
361
361
  ### Example Usage
362
362
 
@@ -516,7 +516,7 @@ run();
516
516
 
517
517
  ## createInvestigationJob
518
518
 
519
- Start an [AI investigation](https://docs.censys.com/docs/platform-ai-investigations) from a set of indicators, a set of previously uploaded evidence files, or both. Supply at least one `indicators` or `file_ids`. To use files, upload them first with the [create file upload endpoint](https://docs.censys.com/reference/v3-threathunting-investigations-files-create).<br><br>This endpoint returns a `job_id` that you can poll to retrieve its status and results.<br><br>Provide `start_time` and `end_time` to scope the investigation to a time frame, or `start_time` alone to scope it from that time up to now. Omit both to investigate current data.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.
519
+ Start an [AI investigation](https://docs.censys.com/docs/platform-ai-investigations) from a set of indicators, a set of previously uploaded evidence files, or both to obtain a report on suspect infrastructure without doing the pivots by hand.<br><br>Supply at least one `indicators` or `file_ids`. To use files, upload them first with the [create file upload endpoint](https://docs.censys.com/reference/v3-threathunting-investigations-files-create).<br><br>This endpoint returns a `job_id` that you can poll to retrieve its status and results.<br><br>Provide `start_time` and `end_time` to scope the investigation to a time frame, or `start_time` alone to scope it from that time up to now. Omit both to investigate current data.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.
520
520
 
521
521
  ### Example Usage
522
522
 
@@ -844,7 +844,7 @@ run();
844
844
 
845
845
  ## createTrackedScan
846
846
 
847
- Initiate a scan to look for a currently unobserved service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Discovery](https://docs.censys.com/docs/platform-threat-hunting-use-live-scan-and-rescan-to-validate-infrastructure#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-threathunting-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module. It costs 15 credits to execute this endpoint.
847
+ Initiate a scan to look for a currently unobserved service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Discovery](https://docs.censys.com/docs/platform-threat-hunting-use-live-scan-and-rescan-to-validate-infrastructure#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-threathunting-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>Use this endpoint to scan for a service at an `ip:port` or `hostname:port`, such as a new IOC from an incident, so you can get data on it right away.<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module. It costs 15 credits to execute this endpoint.
848
848
 
849
849
  ### Example Usage
850
850
 
@@ -936,7 +936,7 @@ run();
936
936
 
937
937
  ## listThreats
938
938
 
939
- Retrieve a list of active threats observed by Censys by aggregating threat IDs across hosts and web properties. Threats are active if their fingerprint has been identified on hosts or web properties by Censys scans. This information is also available on the [Explore Threats page in the Platform web UI](https://platform.censys.io/threats).<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module.
939
+ Retrieve a list of active threats observed by Censys by aggregating threat IDs across hosts and web properties. Use this endpoint to see currently active threats so you can prioritize which malicious infrastructure to hunt or block first.<br><br>Threats are active if their fingerprint has been identified on hosts or web properties by Censys scans. This information is also available on the [Explore Threats page in the Platform web UI](https://platform.censys.io/threats).<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module.
940
940
 
941
941
  ### Example Usage
942
942
 
@@ -1014,7 +1014,7 @@ run();
1014
1014
 
1015
1015
  ## valueCounts
1016
1016
 
1017
- Get counts of web assets for specific field-value pairs and combinations of field-value pairs. This is similar to the [CensEye functionality](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#/) available in the Platform web UI, but it allows you to define specific fields of interest rather than the [default fields](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#default-pivot-fields) leveraged by the tool in the UI.<br><br>Each array can only target fields within the same nested object and may contain at most 5 field-value pairs. For example, you can combine `host.services.port=80` and `host.services.protocol=SSH` in the same array, but you cannot combine `host.services.port=80` and `host.location.country="United States"` in the same array. You can input multiple arrays of objects in each API call.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module. This endpoint costs 1 credit per count condition (array of objects) included in the API call.
1017
+ Get counts of web assets for specific field-value pairs and combinations of field-value pairs. This is similar to the [CensEye functionality](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#/) available in the Platform web UI, but it allows you to define specific fields of interest rather than the [default fields](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#default-pivot-fields) leveraged by the tool in the UI.<br><br>Each array can only target fields within the same nested object and may contain at most 5 field-value pairs. For example, you can combine `host.services.port=80` and `host.services.protocol=SSH` in the same array, but you cannot combine `host.services.port=80` and `host.location.country="United States"` in the same array. You can input multiple arrays of objects in each API call.<br><br>Use this endpoint to see how many assets share a given field value, so you can tell which attributes are rare enough to pivot on and which are too common to be useful.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module. This endpoint costs 1 credit per count condition (array of objects) included in the API call.
1018
1018
 
1019
1019
  ### Example Usage
1020
1020
 
@@ -105,7 +105,7 @@ run();
105
105
 
106
106
  ## create
107
107
 
108
- Create a new collection.<br><br>This endpoint does not cost credits to execute.
108
+ Create a new [collection](https://docs.censys.com/docs/platform-collections).<br><br>In a SOC environment, use this endpoint to save a query as a dynamic asset group, such as all internet-facing RDP hosts or a threat's footprint, so SOC monitoring and reporting stay scoped as assets change.<br><br>This endpoint does not cost credits to execute.
109
109
 
110
110
  ### Example Usage
111
111
 
@@ -269,7 +269,7 @@ run();
269
269
 
270
270
  ## get
271
271
 
272
- Retrieve information about a collection. Retrieved information includes its name, query, description, status, and asset count.<br><br>This endpoint does not cost credits to execute.
272
+ Retrieve information about a collection. Retrieved information includes its name, query, description, status, and asset count. Use it to confirm it still reflects the scope you intend to monitor.<br><br>This endpoint does not cost credits to execute.
273
273
 
274
274
  ### Example Usage
275
275
 
@@ -435,7 +435,7 @@ run();
435
435
 
436
436
  ## listEvents
437
437
 
438
- Retrieve the event history for a collection. This includes the addition or removal of assets as well as collection status changes.<br><br>This endpoint does not cost credits to execute.
438
+ Retrieve the event history for a collection. This includes the addition or removal of assets as well as collection status changes.<br><br>In a SOC environment, use this endpoint to see which assets were added or removed and when, to catch new exposure or unexpected changes in a monitored scope.<br><br>This endpoint does not cost credits to execute.
439
439
 
440
440
  ### Example Usage
441
441
 
@@ -521,7 +521,7 @@ run();
521
521
 
522
522
  ## aggregate
523
523
 
524
- Aggregate results for a Platform search query that targets a collection's assets. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.
524
+ Aggregate results for a Platform search query that targets a collection's assets. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.<br><br>In a SOC environment, use this endpoint to count and bucket matches by field, such as port, country, or software, inside a collection so you can spot exposure trends without pulling every asset.
525
525
 
526
526
  ### Example Usage
527
527
 
@@ -609,7 +609,7 @@ run();
609
609
 
610
610
  ## search
611
611
 
612
- Run a search query across a collection's assets. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax. Host services that match your search criteria will be returned in a `matched_services` object.
612
+ Run a search query across a collection's assets. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax. Host services that match your search criteria will be returned in a `matched_services` object.<br><br>In a SOC environment, use this endpoint to search only within the defined scope of a collection, so triage and hunting results stay relevant instead of covering the whole internet.
613
613
 
614
614
  ### Example Usage
615
615
 
@@ -30,7 +30,7 @@ Endpoints related to the Global Data product
30
30
 
31
31
  ## getCertificates
32
32
 
33
- Retrieve information about multiple certificates. You can retrieve up to 1,000 certificates per call. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
33
+ Retrieve information about multiple certificates. You can retrieve up to 1,000 certificates per call. A certificate ID is its SHA-256 fingerprint.<br><br>In a SOC environment, use this endpoint to bulk-check multiple certificates from network telemetry for self-signed, newly issued, or lookalike certs.
34
34
 
35
35
  ### Example Usage
36
36
 
@@ -116,7 +116,7 @@ run();
116
116
 
117
117
  ## getCertificatesRaw
118
118
 
119
- Retrieve the raw PEM-encoded format for multiple certificates. You can retrieve up to 1,000 certificates per call. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
119
+ Retrieve the raw PEM-encoded format for multiple certificates. You can retrieve up to 1,000 certificates per call. A certificate ID is its SHA-256 fingerprint.<br><br>Use this endpoint to export raw PEMs for multiple certificates at once, for bulk analysis or sharing with your detection pipeline.
120
120
 
121
121
  ### Example Usage
122
122
 
@@ -202,7 +202,7 @@ run();
202
202
 
203
203
  ## getCertificate
204
204
 
205
- Retrieve information about a single certificate. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
205
+ Retrieve information about a single certificate. A certificate ID is its SHA-256 fingerprint.<br><br>In a SOC environment, use this endpoint to look up a certificate by SHA-256 fingerprint to see its subject, issuer, and validity, so you can vet certs seen in TLS logs or alerts.
206
206
 
207
207
  ### Example Usage
208
208
 
@@ -280,7 +280,7 @@ run();
280
280
 
281
281
  ## getCertificateRaw
282
282
 
283
- Retrieve the raw PEM-encoded format of a certificate. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
283
+ Retrieve the raw PEM-encoded format of a certificate. A certificate ID is its SHA-256 fingerprint.<br><br>Use this endpoint to retrieve the raw PEM of a suspicious certificate for offline analysis or to feed other tooling.
284
284
 
285
285
  ### Example Usage
286
286
 
@@ -358,7 +358,7 @@ run();
358
358
 
359
359
  ## getHostEnrichment
360
360
 
361
- Retrieve enrichment data for a single host. This endpoint is optimized for high-volume SOC enrichment use cases.<br><br>This endpoint does not consume standard Censys credits. Core organizations may perform up to 20,000 enrichment calls per day. Core + Unlimited Enrichment organizations may perform an unlimited amount of enrichment calls per day.<br><br>[Learn more about the enrichment API here](https://docs.censys.com/docs/host-enrichment).
361
+ Retrieve enrichment data for a single host. This endpoint is optimized for high-volume SOC enrichment use cases.<br><br>Use this endpoint to add Censys context (location, ASN, labels, reputation, and more) to IPs in your SIEM or SOAR at high volume, without spending standard credits.<br><br>This endpoint does not consume standard Censys credits. Core organizations may perform up to 20,000 enrichment calls per day. Core + Unlimited Enrichment organizations may perform an unlimited amount of enrichment calls per day.<br><br>[Learn more about the enrichment API here](https://docs.censys.com/docs/host-enrichment).
362
362
 
363
363
  ### Example Usage
364
364
 
@@ -437,7 +437,7 @@ run();
437
437
 
438
438
  ## getHosts
439
439
 
440
- Retrieve information about multiple hosts. You can retrieve up to 100 hosts per call. A host ID is its IP address.
440
+ Retrieve information about multiple hosts. You can retrieve up to 100 hosts per call. A host ID is its IP address.<br><br>In a SOC environment, use this endpoint to look up multiple IPs from an alert, log, or threat feed in one call, so you can triage a whole indicator list quickly.
441
441
 
442
442
  ### Example Usage
443
443
 
@@ -525,7 +525,7 @@ run();
525
525
 
526
526
  ## getHost
527
527
 
528
- Retrieve information about a single host. A host ID is its IP address.
528
+ Retrieve information about a single host. A host ID is its IP address.<br><br>In a SOC environment, use this endpoint to pull the current services, software, certificates, and labels on an IP from an alert, so you can quickly judge whether it is malicious or benign.
529
529
 
530
530
  ### Example Usage
531
531
 
@@ -605,7 +605,7 @@ run();
605
605
 
606
606
  ## listServicesOnHost
607
607
 
608
- Retrieve historical service observations for a host. This endpoint returns time ranges during which services were detected on the host.<br><br>You can define a specific time frame of interest. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account.<br><br>You can filter by port number, protocol, and transport protocol.
608
+ Retrieve historical service observations for a host. This endpoint returns time ranges during which services were detected on the host.<br><br>You can define a specific time frame of interest. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account.<br><br>You can filter by port number, protocol, and transport protocol.<br><br>In a SOC environment, use this endpoint to see when a specific service was exposed on an IP, so you can check whether it was live during the window of a suspected incident.
609
609
 
610
610
  ### Example Usage
611
611
 
@@ -695,7 +695,7 @@ run();
695
695
 
696
696
  ## getHostTimeline
697
697
 
698
- Retrieve event history for a host. A host ID is its IP address.<br><br>Note that when a service protocol changes after a new scan (for example, from `UNKNOWN` to `NETBIOS`), this information will be reflected in the `scan` object.
698
+ Retrieve event history for a host. A host ID is its IP address.<br><br>Note that when a service protocol changes after a new scan (for example, from `UNKNOWN` to `NETBIOS`), this information will be reflected in the `scan` object.<br><br>In a SOC environment, use this endpoint to see what changed on an IP over time, such as new services, certificate swaps, and software changes, to reconstruct when attacker infrastructure was stood up or modified.
699
699
 
700
700
  ### Example Usage
701
701
 
@@ -777,7 +777,7 @@ run();
777
777
 
778
778
  ## getWebProperties
779
779
 
780
- Retrieve information about multiple web properties. You can retrieve up to 100 web properties per call. Web properties are identified using a combination of a hostname and port joined with a colon, such as `platform.censys.io:80`.
780
+ Retrieve information about multiple web properties. You can retrieve up to 100 web properties per call. Web properties are identified using a combination of a hostname and port joined with a colon, such as `platform.censys.io:80`.<br><br>In a SOC environment, use this endpoint to check up to 100 suspicious hostnames at once, such as domains from phishing reports or proxy logs, to find the live and malicious ones.
781
781
 
782
782
  ### Example Usage
783
783
 
@@ -865,7 +865,7 @@ run();
865
865
 
866
866
  ## getWebProperty
867
867
 
868
- Retrieve information about a single web property. Web properties are identified using a combination of a hostname and port joined with a colon, such as `platform.censys.io:80`.
868
+ Retrieve information about a single web property. Web properties are identified using a combination of a hostname and port joined with a colon, such as `platform.censys.io:80`.<br><br>In a SOC environment, use this endpoint to inspect the current content, technologies, and certificate for a hostname and port from a phishing or C2 alert.
869
869
 
870
870
  ### Example Usage
871
871
 
@@ -1027,7 +1027,7 @@ run();
1027
1027
 
1028
1028
  ## listDnsIpResolutionBounds
1029
1029
 
1030
- Retrieve the domain names that resolved to an IP during a time frame. You can narrow results with `record_types` (A or AAAA).<br><br>Results are aggregated per domain name and multiple distinct ranges for a name will be grouped into one row of results. For example, if `censys.com` resolved to `1.1.1.1` from January 1 to January 7 during two different ranges of January 1 to January 3 and January 5 to January 7, and you targeted January 1 through January 7 with your API call, then this endpoint will group those ranges into one entry for `censys.com` in the response.<br><br>To retrieve domain names for an IP with each record broken down by time range, use the [ranges endpoint](https://docs.censys.com/reference/v3-globaldata-dns-ip-resolution-ranges)<br><br>This endpoint is only available to organizations on the Censys Search and Censys Core plans.<br><br>[Learn more about Censys Active DNS](https://docs.censys.com/docs/platform-active-dns).
1030
+ Retrieve the domain names that resolved to an IP during a time frame. You can narrow results with `record_types` (A or AAAA).<br><br>Results are aggregated per domain name and multiple distinct ranges for a name will be grouped into one row of results. For example, if `censys.com` resolved to `1.1.1.1` from January 1 to January 7 during two different ranges of January 1 to January 3 and January 5 to January 7, and you targeted January 1 through January 7 with your API call, then this endpoint will group those ranges into one entry for `censys.com` in the response.<br><br>To retrieve domain names for an IP with each record broken down by time range, use the [ranges endpoint](https://docs.censys.com/reference/v3-globaldata-dns-ip-resolution-ranges)<br><br>In a SOC environment, use this endpoint to find every domain that has pointed at a malicious IP, with first- and last-seen bounds per name, so you can discover related domains and block them.<br><br>This endpoint is only available to organizations on the Censys Search and Censys Core plans.<br><br>[Learn more about Censys Active DNS](https://docs.censys.com/docs/platform-active-dns).
1031
1031
 
1032
1032
  ### Example Usage
1033
1033
 
@@ -1117,7 +1117,7 @@ run();
1117
1117
 
1118
1118
  ## listDnsIpResolutionRanges
1119
1119
 
1120
- Retrieve the domain names that resolved to an IP during a time frame. You can narrow results with `record_types` (A or AAAA).<br><br>Record results are broken down based on time range. For example, if `censys.com` resolved to `1.1.1.1` from January 1 to January 7 during two different ranges of January 1 to January 3 and January 5 to January 7, and you targeted January 1 through January 7 with your API call, then this endpoint will return one row for each of those distinct ranges.<br><br>To retrieve domain names for an IP with each result aggregated by name, use the [bounds endpoint endpoint](https://docs.censys.com/reference/v3-globaldata-dns-ip-resolution-bound).<br><br>This endpoint is only available to organizations on the Censys Search and Censys Core plans.<br><br>[Learn more about Censys Active DNS](https://docs.censys.com/docs/platform-active-dns).
1120
+ Retrieve the domain names that resolved to an IP during a time frame. You can narrow results with `record_types` (A or AAAA).<br><br>Record results are broken down based on time range. For example, if `censys.com` resolved to `1.1.1.1` from January 1 to January 7 during two different ranges of January 1 to January 3 and January 5 to January 7, and you targeted January 1 through January 7 with your API call, then this endpoint will return one row for each of those distinct ranges.<br><br>To retrieve domain names for an IP with each result aggregated by name, use the [bounds endpoint endpoint](https://docs.censys.com/reference/v3-globaldata-dns-ip-resolution-bound).<br><br>In a SOC environment, use this endpoint to see the exact time ranges a domain resolved to an IP, to confirm it was active during the incident window or to spot infrastructure reuse.<br><br>This endpoint is only available to organizations on the Censys Search and Censys Core plans.<br><br>[Learn more about Censys Active DNS](https://docs.censys.com/docs/platform-active-dns).
1121
1121
 
1122
1122
  ### Example Usage
1123
1123
 
@@ -1209,7 +1209,7 @@ run();
1209
1209
 
1210
1210
  ## listDnsNameResolutionBounds
1211
1211
 
1212
- Retrieve the DNS resolution records for a name. This endpoint returns observed A, AAAA, MX, NS, SOA, and TXT records for the name you provide. You can filter by one or more record types using record_types.<br><br>Results are aggregated per record distinct ranges for a record will be grouped into one row of results. For example, if `censys.com` resolved to `1.1.1.1` from January 1 to January 7 during two different ranges of January 1 to January 3 and January 5 to January 7, and you targeted January 1 through January 7 with your API call, then this endpoint will group those ranges into one entry for the `1.1.1.1` A record in the response.<br><br>To retrieve records for a name with each record broken down by time range, use the [ranges endpoint](https://docs.censys.com/reference/v3-globaldata-dns-name-resolution-ranges).<br><br>This endpoint is only available to organizations on the Censys Search and Censys Core plans.<br><br>[Learn more about Censys Active DNS](https://docs.censys.com/docs/platform-active-dns).
1212
+ Retrieve the DNS resolution records for a name. This endpoint returns observed A, AAAA, MX, NS, SOA, and TXT records for the name you provide. You can filter by one or more record types using record_types.<br><br>Results are aggregated per record distinct ranges for a record will be grouped into one row of results. For example, if `censys.com` resolved to `1.1.1.1` from January 1 to January 7 during two different ranges of January 1 to January 3 and January 5 to January 7, and you targeted January 1 through January 7 with your API call, then this endpoint will group those ranges into one entry for the `1.1.1.1` A record in the response.<br><br>To retrieve records for a name with each record broken down by time range, use the [ranges endpoint](https://docs.censys.com/reference/v3-globaldata-dns-name-resolution-ranges).<br><br>In a SOC environment, use this endpoint to see the A, AAAA, MX, NS, SOA, and TXT records observed for a suspicious domain, to pivot to its hosting and mail infrastructure.<br><br>This endpoint is only available to organizations on the Censys Search and Censys Core plans.<br><br>[Learn more about Censys Active DNS](https://docs.censys.com/docs/platform-active-dns).
1213
1213
 
1214
1214
  ### Example Usage
1215
1215
 
@@ -1299,7 +1299,7 @@ run();
1299
1299
 
1300
1300
  ## listDnsNameResolutionRanges
1301
1301
 
1302
- Retrieve the records that resolved for a name during a time frame. This endpoint returns observed A, AAAA, MX, NS, SOA, and TXT records for the name you provide. You can filter by one or more record types using `record_types`.<br><br>Record results are broken down based on time range. For example, if `censys.com` resolved to `1.1.1.1` from January 1 to January 7 during two different ranges of January 1 to January 3 and January 5 to January 7, and you targeted January 1 through January 7 with your API call, then this endpoint will return one row for each of those distinct ranges for the `1.1.1.1` A record.<br><br>To retrieve records for a name with each result aggregated per record, use the [bounds endpoint endpoint](https://docs.censys.com/reference/v3-globaldata-dns-name-resolution-bound).<br><br>This endpoint is only available to organizations on the Censys Search and Censys Core plans.<br><br>[Learn more about Censys Active DNS](https://docs.censys.com/docs/platform-active-dns).
1302
+ Retrieve the records that resolved for a name during a time frame. This endpoint returns observed A, AAAA, MX, NS, SOA, and TXT records for the name you provide. You can filter by one or more record types using `record_types`.<br><br>Record results are broken down based on time range. For example, if `censys.com` resolved to `1.1.1.1` from January 1 to January 7 during two different ranges of January 1 to January 3 and January 5 to January 7, and you targeted January 1 through January 7 with your API call, then this endpoint will return one row for each of those distinct ranges for the `1.1.1.1` A record.<br><br>To retrieve records for a name with each result aggregated per record, use the [bounds endpoint endpoint](https://docs.censys.com/reference/v3-globaldata-dns-name-resolution-bound).<br><br>In a SOC environment, use this endpoint to see when a domain's records changed over time, such as a sudden hosting move after takedown.<br><br>This endpoint is only available to organizations on the Censys Search and Censys Core plans.<br><br>[Learn more about Censys Active DNS](https://docs.censys.com/docs/platform-active-dns).
1303
1303
 
1304
1304
  ### Example Usage
1305
1305
 
@@ -1389,7 +1389,7 @@ run();
1389
1389
 
1390
1390
  ## createTrackedScan
1391
1391
 
1392
- Initiate a rescan for a known host service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Rescan](https://docs.censys.com/docs/platform-live-rescan#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-globaldata-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all Enterprise customers. It costs 10 credits to execute.
1392
+ Initiate a rescan for a known host service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Rescan](https://docs.censys.com/docs/platform-live-rescan#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-globaldata-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>In a SOC environment, rescan to ensure triage, an investigation, or a hunt has the most accurate and current state. This includes information like whether C2 servers are still operational, or whether an organization's asset is still exposed to the internet.<br><br>This endpoint is available to all Enterprise customers. It costs 10 credits to execute.
1393
1393
 
1394
1394
  ### Example Usage
1395
1395
 
@@ -1481,7 +1481,7 @@ run();
1481
1481
 
1482
1482
  ## getTrackedScan
1483
1483
 
1484
- Retrieve the current status of a scan by its ID. This endpoint works for both [Live Discovery scans](https://docs.censys.com/reference/v3-threathunting-scans-discovery#/) and [Live Rescans](https://docs.censys.com/reference/v3-globaldata-scans-rescan#/).<br><br>If the scan was successful, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all Enterprise customers. This endpoint does not cost any credits to execute.
1484
+ Retrieve the current status of a scan by its ID. This endpoint works for both [Live Discovery scans](https://docs.censys.com/reference/v3-threathunting-scans-discovery#/) and [Live Rescans](https://docs.censys.com/reference/v3-globaldata-scans-rescan#/).<br><br>Use this endpoint to check whether a Live Discovery or Live Rescan scan has finished, so automation knows when fresh data is ready to pull.<br><br>If the scan was successful, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all enterprise customers. This endpoint does not cost any credits to execute.
1485
1485
 
1486
1486
  ### Example Usage
1487
1487
 
@@ -1559,7 +1559,7 @@ run();
1559
1559
 
1560
1560
  ## aggregate
1561
1561
 
1562
- Aggregate results for a Platform search query. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.
1562
+ Aggregate results for a Platform search query. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.<br><br>In a SOC environment, use this endpoint to count and bucket matches by field, such as country, ASN, or port, to size a campaign or spot where malicious infrastructure clusters without pulling every record.
1563
1563
 
1564
1564
  ### Example Usage
1565
1565
 
@@ -1735,7 +1735,7 @@ run();
1735
1735
 
1736
1736
  ## search
1737
1737
 
1738
- Run a search query across Censys data. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax. Host services that match your search criteria will be returned in a `matched_services` object.
1738
+ Run a search query across Censys data. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax.<br><br>Host services that match your search criteria will be returned in a `matched_services` object.<br><br>In a SOC environment, use this endpoint to hunt for hosts, web properties, or certificates that match an indicator, such as a C2 banner, JARM, or favicon hash to scope infrastructure tied to an alert.
1739
1739
 
1740
1740
  ### Example Usage
1741
1741
 
@@ -660,7 +660,7 @@ run();
660
660
 
661
661
  ## updateTag
662
662
 
663
- Update an existing tag in your organization. Only the fields provided in the request body will be updated; omitted fields are left unchanged.<br><br>Only the tag's creator or an organization admin can update a `private` tag. Tags with the `shared` setting can be updated by any organization member.<br><br>This endpoint does not cost any credits to execute.
663
+ Update an existing tag in your organization. Only the fields provided in the request body will be updated; omitted fields are left unchanged.<br><br>Only the tag's creator or an organization admin can update a `private` tag. Tags with the `shared` setting can be updated by any organization member. A `shared` tag cannot be made `private`.<br><br>This endpoint does not cost any credits to execute.
664
664
 
665
665
  ### Example Usage
666
666
 
@@ -106,7 +106,7 @@ run();
106
106
 
107
107
  ## createCenseyeJob
108
108
 
109
- Create an asynchronous CensEye pivot analysis job for a host, web property, or certificate. The job extracts [default pivot fields](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#default-pivot-fields) from the target asset and counts matching documents for each field-value pair. Poll the job status endpoint to track progress, then retrieve results when complete.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint costs 44 credits to execute for a host, 28 credits to execute for a web property, and 7 credits to execute for a certificate.
109
+ Create an asynchronous CensEye pivot analysis job for a host, web property, or certificate. The job extracts [default pivot fields](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#default-pivot-fields) from the target asset and counts matching documents for each field-value pair. Poll the job status endpoint to track progress, then retrieve results when complete.<br><br>Use this endpoint to start an analysis of a suspicious host, web property, or certificate that finds the rare attributes it shares with other assets, so you can uncover related attacker infrastructure.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint costs 44 credits to execute for a host, 28 credits to execute for a web property, and 7 credits to execute for a certificate.
110
110
 
111
111
  ### Example Usage
112
112
 
@@ -274,7 +274,7 @@ run();
274
274
 
275
275
  ## getCenseyeJobResults
276
276
 
277
- Retrieve the results of a completed CensEye pivot analysis job. Each result contains a count and the field-value pairs that were analyzed. Results may be empty if the job is still running.<br><br>Results are paginated. Use the `next_page_token` from the response to fetch subsequent pages.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.
277
+ Retrieve the results of a completed CensEye pivot analysis job. Use this endpoint to retrieve the pivots from a finished job, then turn the most distinctive ones into searches or blocklist candidates.<br><br>Each result contains a count and the field-value pairs that were analyzed. Results may be empty if the job is still running.<br><br>Results are paginated. Use the `next_page_token` from the response to fetch subsequent pages.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.
278
278
 
279
279
  ### Example Usage
280
280
 
@@ -352,7 +352,7 @@ run();
352
352
 
353
353
  ## getHostObservationsWithCertificate
354
354
 
355
- Retrieve the historical observations of hosts associated with a certificate. This is useful for threat hunting, detection engineering, and timeline generation. Certificate history is also visible to Adversary Investigation users in the Platform UI on the [certificate timeline](https://docs.censys.com/docs/platform-threat-hunting-use-cert-history-to-build-better-detections#/).<br><br>You can define a specific time frame of interest. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account.<br><br>For workspaces with a history limit, the API returns observation ranges that overlap the allowed history window. The window starts at 00:00 UTC the allowed number of days ago and ends at the time of the request. Ranges are returned in full, with their original start and end times, even if they extend outside the window.<br><br>You may also filter results by port and transport protocol.<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module. This endpoint costs one credit per page of results.
355
+ Retrieve the historical observations of hosts associated with a certificate. Use this endpoint to see every host that has presented a given certificate over time, so you can build a timeline and find other infrastructure using it.<br><br>Certificate history is also visible to Adversary Investigation users in the Platform UI on the [certificate timeline](https://docs.censys.com/docs/platform-threat-hunting-use-cert-history-to-build-better-detections#/).<br><br>You can define a specific time frame of interest. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account.<br><br>For workspaces with a history limit, the API returns observation ranges that overlap the allowed history window. The window starts at 00:00 UTC the allowed number of days ago and ends at the time of the request. Ranges are returned in full, with their original start and end times, even if they extend outside the window.<br><br>You may also filter results by port and transport protocol.<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module. This endpoint costs one credit per page of results.
356
356
 
357
357
  ### Example Usage
358
358
 
@@ -440,7 +440,7 @@ run();
440
440
 
441
441
  ## createInvestigationFileUpload
442
442
 
443
- Prepare to attach an evidence file to an investigation. This endpoint does not accept the file. It returns a URL to send the file to and an identifier to pass to the [create job endpoint](https://docs.censys.com/reference/v3-threathunting-investigations-jobs-create) afterwards.<br><br>Upload the file with an HTTP PUT to `upload_url` and send `upload_headers` exactly as returned by this endpoint. The URL grants access to that one file and stops working at `expire_time`; a file uploaded before that stays usable afterwards. Prepare one upload per file.<br><br>Start the investigation promptly after uploading. There is a limit on how many uploaded files you may hold without using them and starting an investigation from a file releases its slot. A file that no investigation references is discarded once it passes the service's retention window for unused uploads. A file an investigation does reference is kept with that investigation for as long as the investigation itself.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint does not cost any credits to execute.
443
+ Prepare to attach an evidence file to an investigation. Use this endpoint to stage evidence, such as logs, malware reports, or alert exports, so an AI investigation can use it.<br><br>This endpoint does not accept the file. It returns a URL to send the file to and an identifier to pass to the [create job endpoint](https://docs.censys.com/reference/v3-threathunting-investigations-jobs-create) afterwards.<br><br>Upload the file with an HTTP PUT to `upload_url` and send `upload_headers` exactly as returned by this endpoint. The URL grants access to that one file and stops working at `expire_time`; a file uploaded before that stays usable afterwards. Prepare one upload per file.<br><br>Start the investigation promptly after uploading. There is a limit on how many uploaded files you may hold without using them and starting an investigation from a file releases its slot. A file that no investigation references is discarded once it passes the service's retention window for unused uploads. A file an investigation does reference is kept with that investigation for as long as the investigation itself.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint does not cost any credits to execute.
444
444
 
445
445
  ### Example Usage
446
446
 
@@ -600,7 +600,7 @@ run();
600
600
 
601
601
  ## createInvestigationJob
602
602
 
603
- Start an [AI investigation](https://docs.censys.com/docs/platform-ai-investigations) from a set of indicators, a set of previously uploaded evidence files, or both. Supply at least one `indicators` or `file_ids`. To use files, upload them first with the [create file upload endpoint](https://docs.censys.com/reference/v3-threathunting-investigations-files-create).<br><br>This endpoint returns a `job_id` that you can poll to retrieve its status and results.<br><br>Provide `start_time` and `end_time` to scope the investigation to a time frame, or `start_time` alone to scope it from that time up to now. Omit both to investigate current data.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.
603
+ Start an [AI investigation](https://docs.censys.com/docs/platform-ai-investigations) from a set of indicators, a set of previously uploaded evidence files, or both to obtain a report on suspect infrastructure without doing the pivots by hand.<br><br>Supply at least one `indicators` or `file_ids`. To use files, upload them first with the [create file upload endpoint](https://docs.censys.com/reference/v3-threathunting-investigations-files-create).<br><br>This endpoint returns a `job_id` that you can poll to retrieve its status and results.<br><br>Provide `start_time` and `end_time` to scope the investigation to a time frame, or `start_time` alone to scope it from that time up to now. Omit both to investigate current data.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.
604
604
 
605
605
  ### Example Usage
606
606
 
@@ -928,7 +928,7 @@ run();
928
928
 
929
929
  ## createTrackedScan
930
930
 
931
- Initiate a scan to look for a currently unobserved service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Discovery](https://docs.censys.com/docs/platform-threat-hunting-use-live-scan-and-rescan-to-validate-infrastructure#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-threathunting-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module. It costs 15 credits to execute this endpoint.
931
+ Initiate a scan to look for a currently unobserved service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Discovery](https://docs.censys.com/docs/platform-threat-hunting-use-live-scan-and-rescan-to-validate-infrastructure#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-threathunting-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>Use this endpoint to scan for a service at an `ip:port` or `hostname:port`, such as a new IOC from an incident, so you can get data on it right away.<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module. It costs 15 credits to execute this endpoint.
932
932
 
933
933
  ### Example Usage
934
934
 
@@ -1020,7 +1020,7 @@ run();
1020
1020
 
1021
1021
  ## getTrackedScanThreatHunting
1022
1022
 
1023
- Retrieve the current status of a scan by its ID. This endpoint works for both [Live Discovery scans](https://docs.censys.com/reference/v3-threathunting-scans-discovery#/) and [Live Rescans](https://docs.censys.com/reference/v3-globaldata-scans-rescan#/).<br><br>If the scan was successful, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all Enterprise customers. This endpoint does not cost any credits to execute.
1023
+ Retrieve the current status of a scan by its ID. This endpoint works for both [Live Discovery scans](https://docs.censys.com/reference/v3-threathunting-scans-discovery#/) and [Live Rescans](https://docs.censys.com/reference/v3-globaldata-scans-rescan#/).<br><br>Use this endpoint to check whether a Live Discovery or Live Rescan scan has finished, so automation knows when fresh data is ready to pull.<br><br>If the scan was successful, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all enterprise customers. This endpoint does not cost any credits to execute.
1024
1024
 
1025
1025
  ### Example Usage
1026
1026
 
@@ -1098,7 +1098,7 @@ run();
1098
1098
 
1099
1099
  ## listThreats
1100
1100
 
1101
- Retrieve a list of active threats observed by Censys by aggregating threat IDs across hosts and web properties. Threats are active if their fingerprint has been identified on hosts or web properties by Censys scans. This information is also available on the [Explore Threats page in the Platform web UI](https://platform.censys.io/threats).<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module.
1101
+ Retrieve a list of active threats observed by Censys by aggregating threat IDs across hosts and web properties. Use this endpoint to see currently active threats so you can prioritize which malicious infrastructure to hunt or block first.<br><br>Threats are active if their fingerprint has been identified on hosts or web properties by Censys scans. This information is also available on the [Explore Threats page in the Platform web UI](https://platform.censys.io/threats).<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module.
1102
1102
 
1103
1103
  ### Example Usage
1104
1104
 
@@ -1176,7 +1176,7 @@ run();
1176
1176
 
1177
1177
  ## valueCounts
1178
1178
 
1179
- Get counts of web assets for specific field-value pairs and combinations of field-value pairs. This is similar to the [CensEye functionality](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#/) available in the Platform web UI, but it allows you to define specific fields of interest rather than the [default fields](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#default-pivot-fields) leveraged by the tool in the UI.<br><br>Each array can only target fields within the same nested object and may contain at most 5 field-value pairs. For example, you can combine `host.services.port=80` and `host.services.protocol=SSH` in the same array, but you cannot combine `host.services.port=80` and `host.location.country="United States"` in the same array. You can input multiple arrays of objects in each API call.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module. This endpoint costs 1 credit per count condition (array of objects) included in the API call.
1179
+ Get counts of web assets for specific field-value pairs and combinations of field-value pairs. This is similar to the [CensEye functionality](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#/) available in the Platform web UI, but it allows you to define specific fields of interest rather than the [default fields](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#default-pivot-fields) leveraged by the tool in the UI.<br><br>Each array can only target fields within the same nested object and may contain at most 5 field-value pairs. For example, you can combine `host.services.port=80` and `host.services.protocol=SSH` in the same array, but you cannot combine `host.services.port=80` and `host.location.country="United States"` in the same array. You can input multiple arrays of objects in each API call.<br><br>Use this endpoint to see how many assets share a given field value, so you can tell which attributes are rare enough to pivot on and which are too common to be useful.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module. This endpoint costs 1 credit per count condition (array of objects) included in the API call.
1180
1180
 
1181
1181
  ### Example Usage
1182
1182
 
@@ -12,7 +12,7 @@ import { Result } from "../types/fp.js";
12
12
  * Aggregate results for a search query within a collection
13
13
  *
14
14
  * @remarks
15
- * Aggregate results for a Platform search query that targets a collection's assets. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.
15
+ * Aggregate results for a Platform search query that targets a collection's assets. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.<br><br>In a SOC environment, use this endpoint to count and bucket matches by field, such as port, country, or software, inside a collection so you can spot exposure trends without pulling every asset.
16
16
  */
17
17
  export declare function collectionsAggregate(client: SDKCore, request: operations.V3CollectionsSearchAggregateRequest, options?: RequestOptions): APIPromise<Result<operations.V3CollectionsSearchAggregateResponse, errors.AuthenticationError | errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
18
18
  //# sourceMappingURL=collectionsAggregate.d.ts.map
@@ -51,7 +51,7 @@ const async_js_1 = require("../types/async.js");
51
51
  * Aggregate results for a search query within a collection
52
52
  *
53
53
  * @remarks
54
- * Aggregate results for a Platform search query that targets a collection's assets. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.
54
+ * Aggregate results for a Platform search query that targets a collection's assets. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.<br><br>In a SOC environment, use this endpoint to count and bucket matches by field, such as port, country, or software, inside a collection so you can spot exposure trends without pulling every asset.
55
55
  */
56
56
  function collectionsAggregate(client, request, options) {
57
57
  return new async_js_1.APIPromise($do(client, request, options));
@@ -12,7 +12,7 @@ import { Result } from "../types/fp.js";
12
12
  * Create a collection
13
13
  *
14
14
  * @remarks
15
- * Create a new collection.<br><br>This endpoint does not cost credits to execute.
15
+ * Create a new [collection](https://docs.censys.com/docs/platform-collections).<br><br>In a SOC environment, use this endpoint to save a query as a dynamic asset group, such as all internet-facing RDP hosts or a threat's footprint, so SOC monitoring and reporting stay scoped as assets change.<br><br>This endpoint does not cost credits to execute.
16
16
  */
17
17
  export declare function collectionsCreate(client: SDKCore, request: operations.V3CollectionsCrudCreateRequest, options?: RequestOptions): APIPromise<Result<operations.V3CollectionsCrudCreateResponse, errors.AuthenticationError | errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
18
18
  //# sourceMappingURL=collectionsCreate.d.ts.map
@@ -51,7 +51,7 @@ const async_js_1 = require("../types/async.js");
51
51
  * Create a collection
52
52
  *
53
53
  * @remarks
54
- * Create a new collection.<br><br>This endpoint does not cost credits to execute.
54
+ * Create a new [collection](https://docs.censys.com/docs/platform-collections).<br><br>In a SOC environment, use this endpoint to save a query as a dynamic asset group, such as all internet-facing RDP hosts or a threat's footprint, so SOC monitoring and reporting stay scoped as assets change.<br><br>This endpoint does not cost credits to execute.
55
55
  */
56
56
  function collectionsCreate(client, request, options) {
57
57
  return new async_js_1.APIPromise($do(client, request, options));
@@ -12,7 +12,7 @@ import { Result } from "../types/fp.js";
12
12
  * Get a collection
13
13
  *
14
14
  * @remarks
15
- * Retrieve information about a collection. Retrieved information includes its name, query, description, status, and asset count.<br><br>This endpoint does not cost credits to execute.
15
+ * Retrieve information about a collection. Retrieved information includes its name, query, description, status, and asset count. Use it to confirm it still reflects the scope you intend to monitor.<br><br>This endpoint does not cost credits to execute.
16
16
  */
17
17
  export declare function collectionsGet(client: SDKCore, request: operations.V3CollectionsCrudGetRequest, options?: RequestOptions): APIPromise<Result<operations.V3CollectionsCrudGetResponse, errors.AuthenticationError | errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
18
18
  //# sourceMappingURL=collectionsGet.d.ts.map
@@ -51,7 +51,7 @@ const async_js_1 = require("../types/async.js");
51
51
  * Get a collection
52
52
  *
53
53
  * @remarks
54
- * Retrieve information about a collection. Retrieved information includes its name, query, description, status, and asset count.<br><br>This endpoint does not cost credits to execute.
54
+ * Retrieve information about a collection. Retrieved information includes its name, query, description, status, and asset count. Use it to confirm it still reflects the scope you intend to monitor.<br><br>This endpoint does not cost credits to execute.
55
55
  */
56
56
  function collectionsGet(client, request, options) {
57
57
  return new async_js_1.APIPromise($do(client, request, options));
@@ -12,7 +12,7 @@ import { Result } from "../types/fp.js";
12
12
  * Get a collection's events
13
13
  *
14
14
  * @remarks
15
- * Retrieve the event history for a collection. This includes the addition or removal of assets as well as collection status changes.<br><br>This endpoint does not cost credits to execute.
15
+ * Retrieve the event history for a collection. This includes the addition or removal of assets as well as collection status changes.<br><br>In a SOC environment, use this endpoint to see which assets were added or removed and when, to catch new exposure or unexpected changes in a monitored scope.<br><br>This endpoint does not cost credits to execute.
16
16
  */
17
17
  export declare function collectionsListEvents(client: SDKCore, request: operations.V3CollectionsListEventsRequest, options?: RequestOptions): APIPromise<Result<operations.V3CollectionsListEventsResponse, errors.AuthenticationError | errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
18
18
  //# sourceMappingURL=collectionsListEvents.d.ts.map
@@ -51,7 +51,7 @@ const async_js_1 = require("../types/async.js");
51
51
  * Get a collection's events
52
52
  *
53
53
  * @remarks
54
- * Retrieve the event history for a collection. This includes the addition or removal of assets as well as collection status changes.<br><br>This endpoint does not cost credits to execute.
54
+ * Retrieve the event history for a collection. This includes the addition or removal of assets as well as collection status changes.<br><br>In a SOC environment, use this endpoint to see which assets were added or removed and when, to catch new exposure or unexpected changes in a monitored scope.<br><br>This endpoint does not cost credits to execute.
55
55
  */
56
56
  function collectionsListEvents(client, request, options) {
57
57
  return new async_js_1.APIPromise($do(client, request, options));
@@ -12,7 +12,7 @@ import { Result } from "../types/fp.js";
12
12
  * Run a search query within a collection
13
13
  *
14
14
  * @remarks
15
- * Run a search query across a collection's assets. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax. Host services that match your search criteria will be returned in a `matched_services` object.
15
+ * Run a search query across a collection's assets. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax. Host services that match your search criteria will be returned in a `matched_services` object.<br><br>In a SOC environment, use this endpoint to search only within the defined scope of a collection, so triage and hunting results stay relevant instead of covering the whole internet.
16
16
  */
17
17
  export declare function collectionsSearch(client: SDKCore, request: operations.V3CollectionsSearchQueryRequest, options?: RequestOptions): APIPromise<Result<operations.V3CollectionsSearchQueryResponse, errors.AuthenticationError | errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
18
18
  //# sourceMappingURL=collectionsSearch.d.ts.map
@@ -51,7 +51,7 @@ const async_js_1 = require("../types/async.js");
51
51
  * Run a search query within a collection
52
52
  *
53
53
  * @remarks
54
- * Run a search query across a collection's assets. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax. Host services that match your search criteria will be returned in a `matched_services` object.
54
+ * Run a search query across a collection's assets. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax. Host services that match your search criteria will be returned in a `matched_services` object.<br><br>In a SOC environment, use this endpoint to search only within the defined scope of a collection, so triage and hunting results stay relevant instead of covering the whole internet.
55
55
  */
56
56
  function collectionsSearch(client, request, options) {
57
57
  return new async_js_1.APIPromise($do(client, request, options));
@@ -12,7 +12,7 @@ import { Result } from "../types/fp.js";
12
12
  * Aggregate results for a search query
13
13
  *
14
14
  * @remarks
15
- * Aggregate results for a Platform search query. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.
15
+ * Aggregate results for a Platform search query. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.<br><br>In a SOC environment, use this endpoint to count and bucket matches by field, such as country, ASN, or port, to size a campaign or spot where malicious infrastructure clusters without pulling every record.
16
16
  */
17
17
  export declare function globalDataAggregate(client: SDKCore, request: operations.V3GlobaldataSearchAggregateRequest, options?: RequestOptions): APIPromise<Result<operations.V3GlobaldataSearchAggregateResponse, errors.AuthenticationError | errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
18
18
  //# sourceMappingURL=globalDataAggregate.d.ts.map
@@ -51,7 +51,7 @@ const async_js_1 = require("../types/async.js");
51
51
  * Aggregate results for a search query
52
52
  *
53
53
  * @remarks
54
- * Aggregate results for a Platform search query. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.
54
+ * Aggregate results for a Platform search query. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.<br><br>In a SOC environment, use this endpoint to count and bucket matches by field, such as country, ASN, or port, to size a campaign or spot where malicious infrastructure clusters without pulling every record.
55
55
  */
56
56
  function globalDataAggregate(client, request, options) {
57
57
  return new async_js_1.APIPromise($do(client, request, options));
@@ -12,7 +12,7 @@ import { Result } from "../types/fp.js";
12
12
  * Live Rescan: Initiate a new rescan
13
13
  *
14
14
  * @remarks
15
- * Initiate a rescan for a known host service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Rescan](https://docs.censys.com/docs/platform-live-rescan#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-globaldata-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all Enterprise customers. It costs 10 credits to execute.
15
+ * Initiate a rescan for a known host service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Rescan](https://docs.censys.com/docs/platform-live-rescan#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-globaldata-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>In a SOC environment, rescan to ensure triage, an investigation, or a hunt has the most accurate and current state. This includes information like whether C2 servers are still operational, or whether an organization's asset is still exposed to the internet.<br><br>This endpoint is available to all Enterprise customers. It costs 10 credits to execute.
16
16
  */
17
17
  export declare function globalDataCreateTrackedScan(client: SDKCore, request: operations.V3GlobaldataScansRescanRequest, options?: RequestOptions): APIPromise<Result<operations.V3GlobaldataScansRescanResponse, errors.AuthenticationError | errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
18
18
  //# sourceMappingURL=globalDataCreateTrackedScan.d.ts.map
@@ -51,7 +51,7 @@ const async_js_1 = require("../types/async.js");
51
51
  * Live Rescan: Initiate a new rescan
52
52
  *
53
53
  * @remarks
54
- * Initiate a rescan for a known host service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Rescan](https://docs.censys.com/docs/platform-live-rescan#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-globaldata-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all Enterprise customers. It costs 10 credits to execute.
54
+ * Initiate a rescan for a known host service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Rescan](https://docs.censys.com/docs/platform-live-rescan#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-globaldata-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>In a SOC environment, rescan to ensure triage, an investigation, or a hunt has the most accurate and current state. This includes information like whether C2 servers are still operational, or whether an organization's asset is still exposed to the internet.<br><br>This endpoint is available to all Enterprise customers. It costs 10 credits to execute.
55
55
  */
56
56
  function globalDataCreateTrackedScan(client, request, options) {
57
57
  return new async_js_1.APIPromise($do(client, request, options));