sync: integrate staging-next codegen (2026-05-04)

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 2195
+configured_endpoints: 2204
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-a6c352830d1270d0abb5bb983058ea21815e1bb7d2e163965335dcb0e706f057.yml
-openapi_spec_hash: aa452e4dfaec546a7e50ef8665bd39f4
-config_hash: d3379006654eb5479a62d9576648acc5
+openapi_spec_hash: e722ad1f58e3dfb3a928cf9890d48da4
+config_hash: ff549978909de2badc92845fea964f4b

src/cloudflare/resources/aisearch/instances/instances.py

@@ -115,6 +115,7 @@ def create(
         cache: bool | Omit = omit,
         cache_threshold: Literal["super_strict_match", "close_enough", "flexible_friend", "anything_goes"]
         | Omit = omit,
+        cache_ttl: Literal[600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400] | Omit = omit,
         chunk: bool | Omit = omit,
         chunk_overlap: int | Omit = omit,
         chunk_size: int | Omit = omit,
@@ -199,6 +200,10 @@ def create(
 
         Lowercase alphanumeric, hyphens, and underscores.
 
+          cache_ttl: Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600
+              (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
+              (72h), 518400 (6d).
+
           hybrid_search_enabled: Deprecated — use index_method instead.
 
           index_method: Controls which storage backends are used during indexing. Defaults to
@@ -226,6 +231,7 @@ def create(
                     "aisearch_model": aisearch_model,
                     "cache": cache,
                     "cache_threshold": cache_threshold,
+                    "cache_ttl": cache_ttl,
                     "chunk": chunk,
                     "chunk_overlap": chunk_overlap,
                     "chunk_size": chunk_size,
@@ -306,6 +312,7 @@ def update(
         cache: bool | Omit = omit,
         cache_threshold: Literal["super_strict_match", "close_enough", "flexible_friend", "anything_goes"]
         | Omit = omit,
+        cache_ttl: Literal[600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400] | Omit = omit,
         chunk: bool | Omit = omit,
         chunk_overlap: int | Omit = omit,
         chunk_size: int | Omit = omit,
@@ -420,10 +427,15 @@ def update(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceUpdateResponse:
-        """
-        Update instance.
+        """Update instance.
 
         Args:
+          cache_ttl: Cache entry TTL in seconds.
+
+        Allowed values: 600 (10min), 1800 (30min), 3600
+              (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
+              (72h), 518400 (6d).
+
           index_method: Controls which storage backends are used during indexing. Defaults to
               vector-only.
 
@@ -450,6 +462,7 @@ def update(
                     "aisearch_model": aisearch_model,
                     "cache": cache,
                     "cache_threshold": cache_threshold,
+                    "cache_ttl": cache_ttl,
                     "chunk": chunk,
                     "chunk_overlap": chunk_overlap,
                     "chunk_size": chunk_size,
@@ -889,6 +902,7 @@ async def create(
         cache: bool | Omit = omit,
         cache_threshold: Literal["super_strict_match", "close_enough", "flexible_friend", "anything_goes"]
         | Omit = omit,
+        cache_ttl: Literal[600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400] | Omit = omit,
         chunk: bool | Omit = omit,
         chunk_overlap: int | Omit = omit,
         chunk_size: int | Omit = omit,
@@ -973,6 +987,10 @@ async def create(
 
         Lowercase alphanumeric, hyphens, and underscores.
 
+          cache_ttl: Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600
+              (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
+              (72h), 518400 (6d).
+
           hybrid_search_enabled: Deprecated — use index_method instead.
 
           index_method: Controls which storage backends are used during indexing. Defaults to
@@ -1000,6 +1018,7 @@ async def create(
                     "aisearch_model": aisearch_model,
                     "cache": cache,
                     "cache_threshold": cache_threshold,
+                    "cache_ttl": cache_ttl,
                     "chunk": chunk,
                     "chunk_overlap": chunk_overlap,
                     "chunk_size": chunk_size,
@@ -1080,6 +1099,7 @@ async def update(
         cache: bool | Omit = omit,
         cache_threshold: Literal["super_strict_match", "close_enough", "flexible_friend", "anything_goes"]
         | Omit = omit,
+        cache_ttl: Literal[600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400] | Omit = omit,
         chunk: bool | Omit = omit,
         chunk_overlap: int | Omit = omit,
         chunk_size: int | Omit = omit,
@@ -1194,10 +1214,15 @@ async def update(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceUpdateResponse:
-        """
-        Update instance.
+        """Update instance.
 
         Args:
+          cache_ttl: Cache entry TTL in seconds.
+
+        Allowed values: 600 (10min), 1800 (30min), 3600
+              (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
+              (72h), 518400 (6d).
+
           index_method: Controls which storage backends are used during indexing. Defaults to
               vector-only.
 
@@ -1224,6 +1249,7 @@ async def update(
                     "aisearch_model": aisearch_model,
                     "cache": cache,
                     "cache_threshold": cache_threshold,
+                    "cache_ttl": cache_ttl,
                     "chunk": chunk,
                     "chunk_overlap": chunk_overlap,
                     "chunk_size": chunk_size,

src/cloudflare/resources/aisearch/namespaces/instances/instances.py

@@ -128,6 +128,7 @@ def create(
         cache: bool | Omit = omit,
         cache_threshold: Literal["super_strict_match", "close_enough", "flexible_friend", "anything_goes"]
         | Omit = omit,
+        cache_ttl: Literal[600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400] | Omit = omit,
         chunk: bool | Omit = omit,
         chunk_overlap: int | Omit = omit,
         chunk_size: int | Omit = omit,
@@ -212,6 +213,10 @@ def create(
 
         Lowercase alphanumeric, hyphens, and underscores.
 
+          cache_ttl: Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600
+              (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
+              (72h), 518400 (6d).
+
           hybrid_search_enabled: Deprecated — use index_method instead.
 
           index_method: Controls which storage backends are used during indexing. Defaults to
@@ -243,6 +248,7 @@ def create(
                     "aisearch_model": aisearch_model,
                     "cache": cache,
                     "cache_threshold": cache_threshold,
+                    "cache_ttl": cache_ttl,
                     "chunk": chunk,
                     "chunk_overlap": chunk_overlap,
                     "chunk_size": chunk_size,
@@ -324,6 +330,7 @@ def update(
         cache: bool | Omit = omit,
         cache_threshold: Literal["super_strict_match", "close_enough", "flexible_friend", "anything_goes"]
         | Omit = omit,
+        cache_ttl: Literal[600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400] | Omit = omit,
         chunk: bool | Omit = omit,
         chunk_overlap: int | Omit = omit,
         chunk_size: int | Omit = omit,
@@ -438,10 +445,15 @@ def update(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceUpdateResponse:
-        """
-        Update instance.
+        """Update instance.
 
         Args:
+          cache_ttl: Cache entry TTL in seconds.
+
+        Allowed values: 600 (10min), 1800 (30min), 3600
+              (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
+              (72h), 518400 (6d).
+
           index_method: Controls which storage backends are used during indexing. Defaults to
               vector-only.
 
@@ -475,6 +487,7 @@ def update(
                     "aisearch_model": aisearch_model,
                     "cache": cache,
                     "cache_threshold": cache_threshold,
+                    "cache_ttl": cache_ttl,
                     "chunk": chunk,
                     "chunk_overlap": chunk_overlap,
                     "chunk_size": chunk_size,
@@ -962,6 +975,7 @@ async def create(
         cache: bool | Omit = omit,
         cache_threshold: Literal["super_strict_match", "close_enough", "flexible_friend", "anything_goes"]
         | Omit = omit,
+        cache_ttl: Literal[600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400] | Omit = omit,
         chunk: bool | Omit = omit,
         chunk_overlap: int | Omit = omit,
         chunk_size: int | Omit = omit,
@@ -1046,6 +1060,10 @@ async def create(
 
         Lowercase alphanumeric, hyphens, and underscores.
 
+          cache_ttl: Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600
+              (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
+              (72h), 518400 (6d).
+
           hybrid_search_enabled: Deprecated — use index_method instead.
 
           index_method: Controls which storage backends are used during indexing. Defaults to
@@ -1077,6 +1095,7 @@ async def create(
                     "aisearch_model": aisearch_model,
                     "cache": cache,
                     "cache_threshold": cache_threshold,
+                    "cache_ttl": cache_ttl,
                     "chunk": chunk,
                     "chunk_overlap": chunk_overlap,
                     "chunk_size": chunk_size,
@@ -1158,6 +1177,7 @@ async def update(
         cache: bool | Omit = omit,
         cache_threshold: Literal["super_strict_match", "close_enough", "flexible_friend", "anything_goes"]
         | Omit = omit,
+        cache_ttl: Literal[600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400] | Omit = omit,
         chunk: bool | Omit = omit,
         chunk_overlap: int | Omit = omit,
         chunk_size: int | Omit = omit,
@@ -1272,10 +1292,15 @@ async def update(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceUpdateResponse:
-        """
-        Update instance.
+        """Update instance.
 
         Args:
+          cache_ttl: Cache entry TTL in seconds.
+
+        Allowed values: 600 (10min), 1800 (30min), 3600
+              (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
+              (72h), 518400 (6d).
+
           index_method: Controls which storage backends are used during indexing. Defaults to
               vector-only.
 
@@ -1309,6 +1334,7 @@ async def update(
                     "aisearch_model": aisearch_model,
                     "cache": cache,
                     "cache_threshold": cache_threshold,
+                    "cache_ttl": cache_ttl,
                     "chunk": chunk,
                     "chunk_overlap": chunk_overlap,
                     "chunk_size": chunk_size,

src/cloudflare/resources/email_security/submissions.py

@@ -51,6 +51,7 @@ def list(
         *,
         account_id: str,
         end: Union[str, datetime] | Omit = omit,
+        escalated_from_user: bool | Omit = omit,
         original_disposition: Literal["MALICIOUS", "SUSPICIOUS", "SPOOF", "SPAM", "BULK", "NONE"] | Omit = omit,
         outcome_disposition: Literal["MALICIOUS", "SUSPICIOUS", "SPOOF", "SPAM", "BULK", "NONE"] | Omit = omit,
         page: int | Omit = omit,
@@ -79,6 +80,10 @@ def list(
 
           end: The end of the search date range. Defaults to `now`.
 
+          escalated_from_user: When true, return only submissions that were escalated by an end user (vs. by
+              the security team). When false, return only submissions that were not escalated
+              by an end user. When omitted, no filter is applied.
+
           page: Current page within paginated list of results.
 
           per_page: The number of results per page. Maximum value is 1000.
@@ -106,6 +111,7 @@ def list(
                 query=maybe_transform(
                     {
                         "end": end,
+                        "escalated_from_user": escalated_from_user,
                         "original_disposition": original_disposition,
                         "outcome_disposition": outcome_disposition,
                         "page": page,
@@ -149,6 +155,7 @@ def list(
         *,
         account_id: str,
         end: Union[str, datetime] | Omit = omit,
+        escalated_from_user: bool | Omit = omit,
         original_disposition: Literal["MALICIOUS", "SUSPICIOUS", "SPOOF", "SPAM", "BULK", "NONE"] | Omit = omit,
         outcome_disposition: Literal["MALICIOUS", "SUSPICIOUS", "SPOOF", "SPAM", "BULK", "NONE"] | Omit = omit,
         page: int | Omit = omit,
@@ -177,6 +184,10 @@ def list(
 
           end: The end of the search date range. Defaults to `now`.
 
+          escalated_from_user: When true, return only submissions that were escalated by an end user (vs. by
+              the security team). When false, return only submissions that were not escalated
+              by an end user. When omitted, no filter is applied.
+
           page: Current page within paginated list of results.
 
           per_page: The number of results per page. Maximum value is 1000.
@@ -204,6 +215,7 @@ def list(
                 query=maybe_transform(
                     {
                         "end": end,
+                        "escalated_from_user": escalated_from_user,
                         "original_disposition": original_disposition,
                         "outcome_disposition": outcome_disposition,
                         "page": page,

src/cloudflare/resources/radar/dns/dns.py

@@ -628,6 +628,7 @@ def timeseries_groups_v2(
             "RESPONSE_CODE",
             "RESPONSE_TTL",
             "TLD",
+            "TLD_DNS_MAGNITUDE",
         ],
         *,
         agg_interval: Literal["15m", "1h", "1d", "1w"] | Omit = omit,
@@ -647,7 +648,7 @@ def timeseries_groups_v2(
         matching_answer: Iterable[bool] | Omit = omit,
         name: SequenceNotStr[str] | Omit = omit,
         nodata: Iterable[bool] | Omit = omit,
-        normalization: Literal["PERCENTAGE", "MIN0_MAX"] | Omit = omit,
+        normalization: Literal["PERCENTAGE", "MIN0_MAX", "RANK"] | Omit = omit,
         protocol: List[Literal["UDP", "TCP", "HTTPS", "TLS"]] | Omit = omit,
         query_type: List[
             Optional[
@@ -1473,6 +1474,7 @@ async def timeseries_groups_v2(
             "RESPONSE_CODE",
             "RESPONSE_TTL",
             "TLD",
+            "TLD_DNS_MAGNITUDE",
         ],
         *,
         agg_interval: Literal["15m", "1h", "1d", "1w"] | Omit = omit,
@@ -1492,7 +1494,7 @@ async def timeseries_groups_v2(
         matching_answer: Iterable[bool] | Omit = omit,
         name: SequenceNotStr[str] | Omit = omit,
         nodata: Iterable[bool] | Omit = omit,
-        normalization: Literal["PERCENTAGE", "MIN0_MAX"] | Omit = omit,
+        normalization: Literal["PERCENTAGE", "MIN0_MAX", "RANK"] | Omit = omit,
         protocol: List[Literal["UDP", "TCP", "HTTPS", "TLS"]] | Omit = omit,
         query_type: List[
             Optional[

src/cloudflare/resources/security_center/api.md

@@ -48,3 +48,43 @@ from cloudflare.types.security_center.insights import TypeGetResponse
 Methods:
 
 - <code title="get /{accounts_or_zones}/{account_or_zone_id}/security-center/insights/type">client.security_center.insights.type.<a href="./src/cloudflare/resources/security_center/insights/type.py">get</a>(\*, account_id, zone_id, \*\*<a href="src/cloudflare/types/security_center/insights/type_get_params.py">params</a>) -> <a href="./src/cloudflare/types/security_center/insights/type_get_response.py">Optional[TypeGetResponse]</a></code>
+
+### AuditLogs
+
+Types:
+
+```python
+from cloudflare.types.security_center.insights import (
+    AuditLogListResponse,
+    AuditLogListByInsightResponse,
+)
+```
+
+Methods:
+
+- <code title="get /{accounts_or_zones}/{account_or_zone_id}/security-center/insights/audit-log">client.security_center.insights.audit_logs.<a href="./src/cloudflare/resources/security_center/insights/audit_logs.py">list</a>(\*, account_id, zone_id, \*\*<a href="src/cloudflare/types/security_center/insights/audit_log_list_params.py">params</a>) -> <a href="./src/cloudflare/types/security_center/insights/audit_log_list_response.py">SyncCursorPagination[AuditLogListResponse]</a></code>
+- <code title="get /{accounts_or_zones}/{account_or_zone_id}/security-center/insights/{issue_id}/audit-log">client.security_center.insights.audit_logs.<a href="./src/cloudflare/resources/security_center/insights/audit_logs.py">list_by_insight</a>(issue_id, \*, account_id, zone_id, \*\*<a href="src/cloudflare/types/security_center/insights/audit_log_list_by_insight_params.py">params</a>) -> <a href="./src/cloudflare/types/security_center/insights/audit_log_list_by_insight_response.py">SyncCursorPagination[AuditLogListByInsightResponse]</a></code>
+
+### Classification
+
+Types:
+
+```python
+from cloudflare.types.security_center.insights import ClassificationUpdateResponse
+```
+
+Methods:
+
+- <code title="patch /{accounts_or_zones}/{account_or_zone_id}/security-center/insights/{issue_id}/classification">client.security_center.insights.classification.<a href="./src/cloudflare/resources/security_center/insights/classification.py">update</a>(issue_id, \*, account_id, zone_id, \*\*<a href="src/cloudflare/types/security_center/insights/classification_update_params.py">params</a>) -> <a href="./src/cloudflare/types/security_center/insights/classification_update_response.py">ClassificationUpdateResponse</a></code>
+
+### Context
+
+Types:
+
+```python
+from cloudflare.types.security_center.insights import ContextGetResponse
+```
+
+Methods:
+
+- <code title="get /accounts/{account_id}/security-center/insights/{issue_id}/context">client.security_center.insights.context.<a href="./src/cloudflare/resources/security_center/insights/context.py">get</a>(issue_id, \*, account_id) -> <a href="./src/cloudflare/types/security_center/insights/context_get_response.py">Optional[ContextGetResponse]</a></code>