feat(api): api update (#2477)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 1542
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-948db90b67e56eee030c84195a5836541eb93a4bc6b46571f1b00d4cf069eb10.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-fc5b966b698b287edea83ecae20186c967fd805bfd665e0b1d0aec760ee85636.yml

src/cloudflare/resources/radar/ai/bots/summary.py

@@ -69,38 +69,37 @@ def user_agent(
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
  ) -> SummaryUserAgentResponse:
  """
- Percentage of Internet traffic generated by AI user agents, over a given time
- period.
+ Retrieves the distribution of traffic by AI user agent.
 
  Args:
- asn: Array of comma separated list of ASNs, start with `-` to exclude from results.
- For example, `-174, 3356` excludes results from AS174, but includes results from
- AS3356.
+ asn: Comma-separated list of Autonomous System Numbers (ASNs). Prefix with `-` to
+ exclude ASNs from results. For example, `-174, 3356` excludes results from
+ AS174, but includes results from AS3356.
 
- continent: Array of comma separated list of continents (alpha-2 continent codes). Start
- with `-` to exclude from results. For example, `-EU,NA` excludes results from
- Europe, but includes results from North America.
+ continent: Comma-separated list of continents (alpha-2 continent codes). Prefix with `-` to
+ exclude continents from results. For example, `-EU,NA` excludes results from EU,
+ but includes results from NA.
 
  date_end: End of the date range (inclusive).
 
- date_range: For example, use `7d` and `7dControl` to compare this week with the previous
- week. Use this parameter or set specific start and end dates (`dateStart` and
- `dateEnd` parameters).
+ date_range: Filters results by the specified date range. For example, use `7d` and
+ `7dcontrol` to compare this week with the previous week. Use this parameter or
+ set specific start and end dates (`dateStart` and `dateEnd` parameters).
 
- date_start: Array of datetimes to filter the start of a series.
+ date_start: Start of the date range.
 
- format: Format results are returned in.
+ format: Format in which results will be returned.
 
- limit_per_group: Limit the number of objects (e.g., browsers, verticals, etc.) to the top items
- within the specified time range. If the limitPerGroup is set, the response will
- include that number of items, with the remaining items grouped together under an
- "other" category.
+ limit_per_group: Limits the number of objects per group to the top items within the specified
+ time range. If there are more items than the limit, the response will include
+ the count of items, with any remaining items grouped together under an "other"
+ category.
 
- location: Array of comma separated list of locations (alpha-2 country codes). Start with
- `-` to exclude from results. For example, `-US,PT` excludes results from the US,
- but includes results from PT.
+ location: Comma-separated list of locations (alpha-2 codes). Prefix with `-` to exclude
+ locations from results. For example, `-US,PT` excludes results from the US, but
+ includes results from PT.
 
- name: Array of names that will be used to name the series in responses.
+ name: Array of names used to label the series in the response.
 
  extra_headers: Send extra headers
 
@@ -177,38 +176,37 @@ async def user_agent(
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
  ) -> SummaryUserAgentResponse:
  """
- Percentage of Internet traffic generated by AI user agents, over a given time
- period.
+ Retrieves the distribution of traffic by AI user agent.
 
  Args:
- asn: Array of comma separated list of ASNs, start with `-` to exclude from results.
- For example, `-174, 3356` excludes results from AS174, but includes results from
- AS3356.
+ asn: Comma-separated list of Autonomous System Numbers (ASNs). Prefix with `-` to
+ exclude ASNs from results. For example, `-174, 3356` excludes results from
+ AS174, but includes results from AS3356.
 
- continent: Array of comma separated list of continents (alpha-2 continent codes). Start
- with `-` to exclude from results. For example, `-EU,NA` excludes results from
- Europe, but includes results from North America.
+ continent: Comma-separated list of continents (alpha-2 continent codes). Prefix with `-` to
+ exclude continents from results. For example, `-EU,NA` excludes results from EU,
+ but includes results from NA.
 
  date_end: End of the date range (inclusive).
 
- date_range: For example, use `7d` and `7dControl` to compare this week with the previous
- week. Use this parameter or set specific start and end dates (`dateStart` and
- `dateEnd` parameters).
+ date_range: Filters results by the specified date range. For example, use `7d` and
+ `7dcontrol` to compare this week with the previous week. Use this parameter or
+ set specific start and end dates (`dateStart` and `dateEnd` parameters).
 
- date_start: Array of datetimes to filter the start of a series.
+ date_start: Start of the date range.
 
- format: Format results are returned in.
+ format: Format in which results will be returned.
 
- limit_per_group: Limit the number of objects (e.g., browsers, verticals, etc.) to the top items
- within the specified time range. If the limitPerGroup is set, the response will
- include that number of items, with the remaining items grouped together under an
- "other" category.
+ limit_per_group: Limits the number of objects per group to the top items within the specified
+ time range. If there are more items than the limit, the response will include
+ the count of items, with any remaining items grouped together under an "other"
+ category.
 
- location: Array of comma separated list of locations (alpha-2 country codes). Start with
- `-` to exclude from results. For example, `-US,PT` excludes results from the US,
- but includes results from PT.
+ location: Comma-separated list of locations (alpha-2 codes). Prefix with `-` to exclude
+ locations from results. For example, `-US,PT` excludes results from the US, but
+ includes results from PT.
 
- name: Array of names that will be used to name the series in responses.
+ name: Array of names used to label the series in the response.
 
  extra_headers: Send extra headers
 

src/cloudflare/resources/radar/ai/inference/summary.py

@@ -67,25 +67,25 @@ def model(
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
  ) -> SummaryModelResponse:
  """
- Percentage distribution of unique accounts by model.
+ Retrieves the distribution of unique accounts by model.
 
  Args:
  date_end: End of the date range (inclusive).
 
- date_range: For example, use `7d` and `7dControl` to compare this week with the previous
- week. Use this parameter or set specific start and end dates (`dateStart` and
- `dateEnd` parameters).
+ date_range: Filters results by the specified date range. For example, use `7d` and
+ `7dcontrol` to compare this week with the previous week. Use this parameter or
+ set specific start and end dates (`dateStart` and `dateEnd` parameters).
 
- date_start: Array of datetimes to filter the start of a series.
+ date_start: Start of the date range.
 
- format: Format results are returned in.
+ format: Format in which results will be returned.
 
- limit_per_group: Limit the number of objects (e.g., browsers, verticals, etc.) to the top items
- within the specified time range. If the limitPerGroup is set, the response will
- include that number of items, with the remaining items grouped together under an
- "other" category.
+ limit_per_group: Limits the number of objects per group to the top items within the specified
+ time range. If there are more items than the limit, the response will include
+ the count of items, with any remaining items grouped together under an "other"
+ category.
 
- name: Array of names that will be used to name the series in responses.
+ name: Array of names used to label the series in the response.
 
  extra_headers: Send extra headers
 
@@ -135,25 +135,25 @@ def task(
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
  ) -> SummaryTaskResponse:
  """
- Percentage distribution of unique accounts by task.
+ Retrieves the distribution of unique accounts by task.
 
  Args:
  date_end: End of the date range (inclusive).
 
- date_range: For example, use `7d` and `7dControl` to compare this week with the previous
- week. Use this parameter or set specific start and end dates (`dateStart` and
- `dateEnd` parameters).
+ date_range: Filters results by the specified date range. For example, use `7d` and
+ `7dcontrol` to compare this week with the previous week. Use this parameter or
+ set specific start and end dates (`dateStart` and `dateEnd` parameters).
 
- date_start: Array of datetimes to filter the start of a series.
+ date_start: Start of the date range.
 
- format: Format results are returned in.
+ format: Format in which results will be returned.
 
- limit_per_group: Limit the number of objects (e.g., browsers, verticals, etc.) to the top items
- within the specified time range. If the limitPerGroup is set, the response will
- include that number of items, with the remaining items grouped together under an
- "other" category.
+ limit_per_group: Limits the number of objects per group to the top items within the specified
+ time range. If there are more items than the limit, the response will include
+ the count of items, with any remaining items grouped together under an "other"
+ category.
 
- name: Array of names that will be used to name the series in responses.
+ name: Array of names used to label the series in the response.
 
  extra_headers: Send extra headers
 
@@ -224,25 +224,25 @@ async def model(
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
  ) -> SummaryModelResponse:
  """
- Percentage distribution of unique accounts by model.
+ Retrieves the distribution of unique accounts by model.
 
  Args:
  date_end: End of the date range (inclusive).
 
- date_range: For example, use `7d` and `7dControl` to compare this week with the previous
- week. Use this parameter or set specific start and end dates (`dateStart` and
- `dateEnd` parameters).
+ date_range: Filters results by the specified date range. For example, use `7d` and
+ `7dcontrol` to compare this week with the previous week. Use this parameter or
+ set specific start and end dates (`dateStart` and `dateEnd` parameters).
 
- date_start: Array of datetimes to filter the start of a series.
+ date_start: Start of the date range.
 
- format: Format results are returned in.
+ format: Format in which results will be returned.
 
- limit_per_group: Limit the number of objects (e.g., browsers, verticals, etc.) to the top items
- within the specified time range. If the limitPerGroup is set, the response will
- include that number of items, with the remaining items grouped together under an
- "other" category.
+ limit_per_group: Limits the number of objects per group to the top items within the specified
+ time range. If there are more items than the limit, the response will include
+ the count of items, with any remaining items grouped together under an "other"
+ category.
 
- name: Array of names that will be used to name the series in responses.
+ name: Array of names used to label the series in the response.
 
  extra_headers: Send extra headers
 
@@ -292,25 +292,25 @@ async def task(
  timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
  ) -> SummaryTaskResponse:
  """
- Percentage distribution of unique accounts by task.
+ Retrieves the distribution of unique accounts by task.
 
  Args:
  date_end: End of the date range (inclusive).
 
- date_range: For example, use `7d` and `7dControl` to compare this week with the previous
- week. Use this parameter or set specific start and end dates (`dateStart` and
- `dateEnd` parameters).
+ date_range: Filters results by the specified date range. For example, use `7d` and
+ `7dcontrol` to compare this week with the previous week. Use this parameter or
+ set specific start and end dates (`dateStart` and `dateEnd` parameters).
 
- date_start: Array of datetimes to filter the start of a series.
+ date_start: Start of the date range.
 
- format: Format results are returned in.
+ format: Format in which results will be returned.
 
- limit_per_group: Limit the number of objects (e.g., browsers, verticals, etc.) to the top items
- within the specified time range. If the limitPerGroup is set, the response will
- include that number of items, with the remaining items grouped together under an
- "other" category.
+ limit_per_group: Limits the number of objects per group to the top items within the specified
+ time range. If there are more items than the limit, the response will include
+ the count of items, with any remaining items grouped together under an "other"
+ category.
 
- name: Array of names that will be used to name the series in responses.
+ name: Array of names used to label the series in the response.
 
  extra_headers: Send extra headers