feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 1782
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-63dee2ea2074a05a12be2424a90cf07824a344d76f5d36a9a92628475f04865b.yml
-openapi_spec_hash: 8b479e1bea4edb1322399d8c0b87d755
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-40c07ef8632f57de126ee942ec6fb7825531ead759a525f0818d1f857e7df689.yml
+openapi_spec_hash: 439492f25df369220720aa93f8a61ad5
 config_hash: eda5b3d9487ce675d1fadf88153b457d

src/cloudflare/resources/cloudforce_one/threat_events/threat_events.py

@@ -213,10 +213,10 @@ def create(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> ThreatEventCreateResponse:
         """
-        Events must be created in a client-specific dataset, which means the `datasetId`
-        parameter must be defined. To create a dataset, see the
+        To create a dataset, see the
         [`Create Dataset`](https://developers.cloudflare.com/api/resources/cloudforce_one/subresources/threat_events/subresources/datasets/methods/create/)
-        endpoint.
+        endpoint. When `datasetId` parameter is unspecified, it will be created in a
+        default dataset named `Cloudforce One Threat Events`.
 
         Args:
           path_account_id: Account ID.
@@ -277,8 +277,9 @@ def list(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> ThreatEventListResponse:
         """
-        The `datasetId` must be defined (to list existing datasets (and their IDs), use
-        the
+        When `datasetId` is unspecified, events will be listed from the
+        `Cloudforce One Threat Events` dataset. To list existing datasets (and their
+        IDs), use the
         [`List Datasets`](https://developers.cloudflare.com/api/resources/cloudforce_one/subresources/threat_events/subresources/datasets/methods/list/)
         endpoint). Also, must provide query parameters.
 
@@ -610,10 +611,10 @@ async def create(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> ThreatEventCreateResponse:
         """
-        Events must be created in a client-specific dataset, which means the `datasetId`
-        parameter must be defined. To create a dataset, see the
+        To create a dataset, see the
         [`Create Dataset`](https://developers.cloudflare.com/api/resources/cloudforce_one/subresources/threat_events/subresources/datasets/methods/create/)
-        endpoint.
+        endpoint. When `datasetId` parameter is unspecified, it will be created in a
+        default dataset named `Cloudforce One Threat Events`.
 
         Args:
           path_account_id: Account ID.
@@ -674,8 +675,9 @@ async def list(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> ThreatEventListResponse:
         """
-        The `datasetId` must be defined (to list existing datasets (and their IDs), use
-        the
+        When `datasetId` is unspecified, events will be listed from the
+        `Cloudforce One Threat Events` dataset. To list existing datasets (and their
+        IDs), use the
         [`List Datasets`](https://developers.cloudflare.com/api/resources/cloudforce_one/subresources/threat_events/subresources/datasets/methods/list/)
         endpoint). Also, must provide query parameters.