Skip to content

Commit 0ee5719

Browse files
chore(api): update composite API spec
1 parent 6bf05ea commit 0ee5719

12 files changed

Lines changed: 115 additions & 27 deletions

File tree

.stats.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
configured_endpoints: 2192
2-
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-c3f5a3865869371d57f04a16ce426de0c723e9904e3b0cb9fc7891a1c6680926.yml
3-
openapi_spec_hash: fa3d976ce364922696ed217ea8820716
2+
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-d002758d193b43db6ad27d2cacddace8c80ef50ea44408e961718b6a90bb8bc1.yml
3+
openapi_spec_hash: 072a97bb2cb80fb3bbbf9833372d2348
44
config_hash: f5c07311bfa023d17aa668eba5d06a13

src/cloudflare/resources/brand_protection/v2/matches.py

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -65,12 +65,13 @@ def get(
6565
"""
6666
Get paginated list of domain matches for one or more brand protection queries.
6767
When multiple query_ids are provided (comma-separated), matches are deduplicated
68-
across queries and each match includes a matched_queries array.
68+
across queries and each match includes a match_details array with per-match
69+
query metadata and individual dismissed state.
6970
7071
Args:
7172
query_id: Query ID or comma-separated list of Query IDs. When multiple IDs are provided,
72-
matches are deduplicated across queries and each match includes matched_queries
73-
and match_ids arrays.
73+
matches are deduplicated across queries and each match includes a match_details
74+
array with per-match query metadata and dismissed state.
7475
7576
domain_search: Filter matches by domain name (substring match)
7677
@@ -159,12 +160,13 @@ async def get(
159160
"""
160161
Get paginated list of domain matches for one or more brand protection queries.
161162
When multiple query_ids are provided (comma-separated), matches are deduplicated
162-
across queries and each match includes a matched_queries array.
163+
across queries and each match includes a match_details array with per-match
164+
query metadata and individual dismissed state.
163165
164166
Args:
165167
query_id: Query ID or comma-separated list of Query IDs. When multiple IDs are provided,
166-
matches are deduplicated across queries and each match includes matched_queries
167-
and match_ids arrays.
168+
matches are deduplicated across queries and each match includes a match_details
169+
array with per-match query metadata and dismissed state.
168170
169171
domain_search: Filter matches by domain name (substring match)
170172

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

Lines changed: 16 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -276,11 +276,11 @@ def list(
276276
timeout: float | httpx.Timeout | None | NotGiven = not_given,
277277
) -> ThreatEventListResponse:
278278
"""
279-
When `datasetId` is unspecified, events will be listed from the
280-
`Cloudforce One Threat Events` dataset. To list existing datasets (and their
281-
IDs), use the
279+
Use `datasetId=all` or `datasetId=*` to query all event datasets for the account
280+
(limited to 10). When `datasetId` is unspecified, events are listed from the
281+
default Cloudforce One Threat Events dataset. To list existing datasets, use the
282282
[`List Datasets`](https://developers.cloudflare.com/api/resources/cloudforce_one/subresources/threat_events/subresources/datasets/methods/list/)
283-
endpoint). Also, must provide query parameters.
283+
endpoint.
284284
285285
Args:
286286
account_id: Account ID.
@@ -290,6 +290,10 @@ def list(
290290
result_info.cursor field. Use cursor-based pagination for deep pagination
291291
(beyond 100,000 records) or for optimal performance.
292292
293+
dataset_id: Dataset IDs to query events from (array of UUIDs), or special value 'all' or
294+
'\\**' to query all event datasets for the account. If not provided, uses the
295+
default dataset.
296+
293297
page: Page number (1-indexed) for offset-based pagination. Limited to offset of
294298
100,000 records. For deep pagination, use cursor-based pagination instead.
295299
@@ -675,11 +679,11 @@ async def list(
675679
timeout: float | httpx.Timeout | None | NotGiven = not_given,
676680
) -> ThreatEventListResponse:
677681
"""
678-
When `datasetId` is unspecified, events will be listed from the
679-
`Cloudforce One Threat Events` dataset. To list existing datasets (and their
680-
IDs), use the
682+
Use `datasetId=all` or `datasetId=*` to query all event datasets for the account
683+
(limited to 10). When `datasetId` is unspecified, events are listed from the
684+
default Cloudforce One Threat Events dataset. To list existing datasets, use the
681685
[`List Datasets`](https://developers.cloudflare.com/api/resources/cloudforce_one/subresources/threat_events/subresources/datasets/methods/list/)
682-
endpoint). Also, must provide query parameters.
686+
endpoint.
683687
684688
Args:
685689
account_id: Account ID.
@@ -689,6 +693,10 @@ async def list(
689693
result_info.cursor field. Use cursor-based pagination for deep pagination
690694
(beyond 100,000 records) or for optimal performance.
691695
696+
dataset_id: Dataset IDs to query events from (array of UUIDs), or special value 'all' or
697+
'\\**' to query all event datasets for the account. If not provided, uses the
698+
default dataset.
699+
692700
page: Page number (1-indexed) for offset-based pagination. Limited to offset of
693701
100,000 records. For deep pagination, use cursor-based pagination instead.
694702

src/cloudflare/resources/dns/settings/account/account.py

Lines changed: 28 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,7 @@ def edit(
6161
self,
6262
*,
6363
account_id: str | None = None,
64+
enforce_dns_only: bool | Omit = omit,
6465
zone_defaults: account_edit_params.ZoneDefaults | Omit = omit,
6566
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
6667
# The extra values given here take precedence over values defined on the client or passed to this method.
@@ -75,6 +76,12 @@ def edit(
7576
Args:
7677
account_id: Identifier.
7778
79+
enforce_dns_only: When enabled, forces all proxied DNS records in the account to behave as
80+
DNS-only at the edge, regardless of each record's individual proxy setting. Note
81+
that this account-level override does not modify the records themselves; it only
82+
affects how they are served at the edge. See more on
83+
[Enforce DNS-only](https://developers.cloudflare.com/dns/proxy-status/enforce-dns-only).
84+
7885
extra_headers: Send extra headers
7986
8087
extra_query: Add additional query parameters to the request
@@ -89,7 +96,13 @@ def edit(
8996
raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
9097
return self._patch(
9198
path_template("/accounts/{account_id}/dns_settings", account_id=account_id),
92-
body=maybe_transform({"zone_defaults": zone_defaults}, account_edit_params.AccountEditParams),
99+
body=maybe_transform(
100+
{
101+
"enforce_dns_only": enforce_dns_only,
102+
"zone_defaults": zone_defaults,
103+
},
104+
account_edit_params.AccountEditParams,
105+
),
93106
options=make_request_options(
94107
extra_headers=extra_headers,
95108
extra_query=extra_query,
@@ -170,6 +183,7 @@ async def edit(
170183
self,
171184
*,
172185
account_id: str | None = None,
186+
enforce_dns_only: bool | Omit = omit,
173187
zone_defaults: account_edit_params.ZoneDefaults | Omit = omit,
174188
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
175189
# The extra values given here take precedence over values defined on the client or passed to this method.
@@ -184,6 +198,12 @@ async def edit(
184198
Args:
185199
account_id: Identifier.
186200
201+
enforce_dns_only: When enabled, forces all proxied DNS records in the account to behave as
202+
DNS-only at the edge, regardless of each record's individual proxy setting. Note
203+
that this account-level override does not modify the records themselves; it only
204+
affects how they are served at the edge. See more on
205+
[Enforce DNS-only](https://developers.cloudflare.com/dns/proxy-status/enforce-dns-only).
206+
187207
extra_headers: Send extra headers
188208
189209
extra_query: Add additional query parameters to the request
@@ -198,7 +218,13 @@ async def edit(
198218
raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
199219
return await self._patch(
200220
path_template("/accounts/{account_id}/dns_settings", account_id=account_id),
201-
body=await async_maybe_transform({"zone_defaults": zone_defaults}, account_edit_params.AccountEditParams),
221+
body=await async_maybe_transform(
222+
{
223+
"enforce_dns_only": enforce_dns_only,
224+
"zone_defaults": zone_defaults,
225+
},
226+
account_edit_params.AccountEditParams,
227+
),
202228
options=make_request_options(
203229
extra_headers=extra_headers,
204230
extra_query=extra_query,

src/cloudflare/types/brand_protection/v2/match_get_params.py

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,8 @@ class MatchGetParams(TypedDict, total=False):
1717
"""Query ID or comma-separated list of Query IDs.
1818
1919
When multiple IDs are provided, matches are deduplicated across queries and each
20-
match includes matched_queries and match_ids arrays.
20+
match includes a match_details array with per-match query metadata and dismissed
21+
state.
2122
"""
2223

2324
domain_search: str

src/cloudflare/types/brand_protection/v2/match_get_response.py

Lines changed: 18 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,26 @@
44

55
from ...._models import BaseModel
66

7-
__all__ = ["MatchGetResponse", "Match", "MatchPublicScans"]
7+
__all__ = ["MatchGetResponse", "Match", "MatchPublicScans", "MatchMatchDetail"]
88

99

1010
class MatchPublicScans(BaseModel):
1111
submission_id: str
1212

1313

14-
class Match(BaseModel):
14+
class MatchMatchDetail(BaseModel):
1515
dismissed: bool
16+
"""Individual dismissed state for this specific match."""
17+
18+
match_id: int
19+
20+
query_id: int
21+
22+
query_tag: Optional[str] = None
23+
"""Tag associated with the query, if one exists."""
1624

25+
26+
class Match(BaseModel):
1727
domain: str
1828

1929
first_seen: str
@@ -28,14 +38,15 @@ class Match(BaseModel):
2838

2939
source: Optional[str] = None
3040

31-
match_ids: Optional[List[int]] = None
32-
"""All underlying match row IDs for this domain.
41+
dismissed: Optional[bool] = None
42+
"""Whether the match is dismissed.
3343
34-
Only present when multiple query_ids are requested.
44+
Only present for single-query requests. For multi-query requests, use the
45+
dismissed field in each match_details entry.
3546
"""
3647

37-
matched_queries: Optional[List[int]] = None
38-
"""List of query IDs that produced this match.
48+
match_details: Optional[List[MatchMatchDetail]] = None
49+
"""Per-match detail objects with query metadata and individual dismissed state.
3950
4051
Only present when multiple query_ids are requested.
4152
"""

src/cloudflare/types/cloudforce_one/threat_event_list_params.py

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,11 @@ class ThreatEventListParams(TypedDict, total=False):
2525
"""
2626

2727
dataset_id: Annotated[SequenceNotStr[str], PropertyInfo(alias="datasetId")]
28+
"""
29+
Dataset IDs to query events from (array of UUIDs), or special value 'all' or
30+
'\\**' to query all event datasets for the account. If not provided, uses the
31+
default dataset.
32+
"""
2833

2934
force_refresh: Annotated[bool, PropertyInfo(alias="forceRefresh")]
3035

src/cloudflare/types/dns/settings/account_edit_params.py

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,15 @@ class AccountEditParams(TypedDict, total=False):
1212
account_id: str
1313
"""Identifier."""
1414

15+
enforce_dns_only: bool
16+
"""
17+
When enabled, forces all proxied DNS records in the account to behave as
18+
DNS-only at the edge, regardless of each record's individual proxy setting. Note
19+
that this account-level override does not modify the records themselves; it only
20+
affects how they are served at the edge. See more on
21+
[Enforce DNS-only](https://developers.cloudflare.com/dns/proxy-status/enforce-dns-only).
22+
"""
23+
1524
zone_defaults: ZoneDefaults
1625

1726

src/cloudflare/types/dns/settings/account_edit_response.py

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,3 +114,12 @@ class ZoneDefaults(BaseModel):
114114

115115
class AccountEditResponse(BaseModel):
116116
zone_defaults: ZoneDefaults
117+
118+
enforce_dns_only: Optional[bool] = None
119+
"""
120+
When enabled, forces all proxied DNS records in the account to behave as
121+
DNS-only at the edge, regardless of each record's individual proxy setting. Note
122+
that this account-level override does not modify the records themselves; it only
123+
affects how they are served at the edge. See more on
124+
[Enforce DNS-only](https://developers.cloudflare.com/dns/proxy-status/enforce-dns-only).
125+
"""

src/cloudflare/types/dns/settings/account_get_response.py

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,3 +114,12 @@ class ZoneDefaults(BaseModel):
114114

115115
class AccountGetResponse(BaseModel):
116116
zone_defaults: ZoneDefaults
117+
118+
enforce_dns_only: Optional[bool] = None
119+
"""
120+
When enabled, forces all proxied DNS records in the account to behave as
121+
DNS-only at the edge, regardless of each record's individual proxy setting. Note
122+
that this account-level override does not modify the records themselves; it only
123+
affects how they are served at the edge. See more on
124+
[Enforce DNS-only](https://developers.cloudflare.com/dns/proxy-status/enforce-dns-only).
125+
"""

0 commit comments

Comments
 (0)