chore(api): update composite API spec

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 2192
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-8d1ce6c5608563d8f7c974108d59033116d234666eb72d8d1227af2994a4fef7.yml
-openapi_spec_hash: 00d82a3a7a91eeb2f55dc0654dfe22ff
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-c3f5a3865869371d57f04a16ce426de0c723e9904e3b0cb9fc7891a1c6680926.yml
+openapi_spec_hash: fa3d976ce364922696ed217ea8820716
 config_hash: f5c07311bfa023d17aa668eba5d06a13

src/cloudflare/resources/ai/finetunes/assets.py

@@ -6,7 +6,7 @@
 
 import httpx
 
-from ...._types import Body, Omit, Query, Headers, NotGiven, FileTypes, omit, not_given
+from ...._types import Body, Query, Headers, NotGiven, FileTypes, not_given
 from ...._utils import extract_files, path_template, maybe_transform, deepcopy_minimal, async_maybe_transform
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
@@ -48,8 +48,8 @@ def create(
         finetune_id: str,
         *,
         account_id: str | None = None,
-        file: FileTypes | Omit = omit,
-        file_name: str | Omit = omit,
+        file: FileTypes,
+        file_name: str,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -61,6 +61,10 @@ def create(
         Uploads training data assets for a Workers AI fine-tuning job.
 
         Args:
+          file: File to upload
+
+          file_name: Name of the file (adapter_config.json or adapter_model.safetensors)
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -126,8 +130,8 @@ async def create(
         finetune_id: str,
         *,
         account_id: str | None = None,
-        file: FileTypes | Omit = omit,
-        file_name: str | Omit = omit,
+        file: FileTypes,
+        file_name: str,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -139,6 +143,10 @@ async def create(
         Uploads training data assets for a Workers AI fine-tuning job.
 
         Args:
+          file: File to upload
+
+          file_name: Name of the file (adapter_config.json or adapter_model.safetensors)
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request

src/cloudflare/resources/workflows/instances/status.py

@@ -7,7 +7,7 @@
 
 import httpx
 
-from ...._types import Body, Query, Headers, NotGiven, not_given
+from ...._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from ...._utils import path_template, maybe_transform, async_maybe_transform
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
@@ -52,6 +52,7 @@ def edit(
         account_id: str | None = None,
         workflow_name: str,
         status: Literal["resume", "pause", "terminate", "restart"],
+        from_: status_edit_params.From | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -66,6 +67,8 @@ def edit(
         Args:
           status: Apply action to instance.
 
+          from_: Step to restart from. Only applicable when status is "restart".
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -89,7 +92,13 @@ def edit(
                 workflow_name=workflow_name,
                 instance_id=instance_id,
             ),
-            body=maybe_transform({"status": status}, status_edit_params.StatusEditParams),
+            body=maybe_transform(
+                {
+                    "status": status,
+                    "from_": from_,
+                },
+                status_edit_params.StatusEditParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -128,6 +137,7 @@ async def edit(
         account_id: str | None = None,
         workflow_name: str,
         status: Literal["resume", "pause", "terminate", "restart"],
+        from_: status_edit_params.From | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -142,6 +152,8 @@ async def edit(
         Args:
           status: Apply action to instance.
 
+          from_: Step to restart from. Only applicable when status is "restart".
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -165,7 +177,13 @@ async def edit(
                 workflow_name=workflow_name,
                 instance_id=instance_id,
             ),
-            body=await async_maybe_transform({"status": status}, status_edit_params.StatusEditParams),
+            body=await async_maybe_transform(
+                {
+                    "status": status,
+                    "from_": from_,
+                },
+                status_edit_params.StatusEditParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,

src/cloudflare/types/ai/finetunes/asset_create_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing_extensions import TypedDict
+from typing_extensions import Required, TypedDict
 
 from ...._types import FileTypes
 
@@ -12,6 +12,8 @@
 class AssetCreateParams(TypedDict, total=False):
     account_id: str
 
-    file: FileTypes
+    file: Required[FileTypes]
+    """File to upload"""
 
-    file_name: str
+    file_name: Required[str]
+    """Name of the file (adapter_config.json or adapter_model.safetensors)"""

src/cloudflare/types/email_security/investigate/detection_get_response.py

@@ -5,7 +5,16 @@
 
 from ...._models import BaseModel
 
-__all__ = ["DetectionGetResponse", "Attachment", "Header", "Link", "SenderInfo", "ThreatCategory", "Validation"]
+__all__ = [
+    "DetectionGetResponse",
+    "Attachment",
+    "Finding",
+    "Header",
+    "Link",
+    "SenderInfo",
+    "ThreatCategory",
+    "Validation",
+]
 
 
 class Attachment(BaseModel):
@@ -33,6 +42,39 @@ class Attachment(BaseModel):
     name: Optional[str] = None
 
 
+class Finding(BaseModel):
+    attachment: Optional[str] = None
+
+    detail: Optional[str] = None
+
+    detection: Optional[
+        Literal[
+            "MALICIOUS",
+            "MALICIOUS-BEC",
+            "SUSPICIOUS",
+            "SPOOF",
+            "SPAM",
+            "BULK",
+            "ENCRYPTED",
+            "EXTERNAL",
+            "UNKNOWN",
+            "NONE",
+        ]
+    ] = None
+
+    field: Optional[str] = None
+
+    name: Optional[str] = None
+
+    portion: Optional[str] = None
+
+    reason: Optional[str] = None
+
+    score: Optional[float] = None
+
+    value: Optional[str] = None
+
+
 class Header(BaseModel):
     name: str
 
@@ -82,6 +124,8 @@ class DetectionGetResponse(BaseModel):
 
     attachments: List[Attachment]
 
+    findings: List[Finding]
+
     headers: List[Header]
 
     links: List[Link]

src/cloudflare/types/email_security/investigate_get_response.py

@@ -128,6 +128,10 @@ class InvestigateGetResponse(BaseModel):
         ]
     ] = None
 
+    delivery_status: Optional[
+        List[Literal["delivered", "moved", "quarantined", "rejected", "deferred", "bounced", "queued"]]
+    ] = None
+
     edf_hash: Optional[str] = None
 
     envelope_from: Optional[str] = None
@@ -150,7 +154,7 @@ class InvestigateGetResponse(BaseModel):
     ] = None
 
     findings: Optional[List[Finding]] = None
-    """Deprecated."""
+    """Deprecated: use `/investigate/{id}/detections` instead."""
 
     from_: Optional[str] = FieldInfo(alias="from", default=None)
 

src/cloudflare/types/email_security/investigate_list_response.py

@@ -128,6 +128,10 @@ class InvestigateListResponse(BaseModel):
         ]
     ] = None
 
+    delivery_status: Optional[
+        List[Literal["delivered", "moved", "quarantined", "rejected", "deferred", "bounced", "queued"]]
+    ] = None
+
     edf_hash: Optional[str] = None
 
     envelope_from: Optional[str] = None
@@ -150,7 +154,7 @@ class InvestigateListResponse(BaseModel):
     ] = None
 
     findings: Optional[List[Finding]] = None
-    """Deprecated."""
+    """Deprecated: use `/investigate/{id}/detections` instead."""
 
     from_: Optional[str] = FieldInfo(alias="from", default=None)
 

src/cloudflare/types/vulnerability_scanner/scan_create_response.py

@@ -1,8 +1,9 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 from typing import List, Union, Optional
-from typing_extensions import Literal, TypeAlias
+from typing_extensions import Literal, Annotated, TypeAlias
 
+from ..._utils import PropertyInfo
 from ..._models import BaseModel
 
 __all__ = [
@@ -21,10 +22,10 @@
     "ReportReportTestStepRequestVariableCapture",
     "ReportReportTestStepResponse",
     "ReportReportTestStepResponseBody",
-    "ReportReportTestStepResponseBodyKind",
-    "ReportReportTestStepResponseBodyUnionMember1",
-    "ReportReportTestStepResponseBodyUnionMember2",
-    "ReportReportTestStepResponseBodyUnionMember3",
+    "ReportReportTestStepResponseBodyVulnScannerBOLABodyResponseNotFound",
+    "ReportReportTestStepResponseBodyVulnScannerBOLABodyResponseBytes",
+    "ReportReportTestStepResponseBodyVulnScannerBOLABodyResponseText",
+    "ReportReportTestStepResponseBodyVulnScannerBOLABodyResponseJson",
     "ReportReportTestPreflightError",
 ]
 
@@ -123,13 +124,13 @@ class ReportReportTestStepRequest(BaseModel):
     """Request body, if any."""
 
 
-class ReportReportTestStepResponseBodyKind(BaseModel):
+class ReportReportTestStepResponseBodyVulnScannerBOLABodyResponseNotFound(BaseModel):
     """No body was received."""
 
     kind: Literal["not_found"]
 
 
-class ReportReportTestStepResponseBodyUnionMember1(BaseModel):
+class ReportReportTestStepResponseBodyVulnScannerBOLABodyResponseBytes(BaseModel):
     """Body received but unable to read as UTF-8. Raw bytes, base64-encoded."""
 
     contents: str
@@ -139,7 +140,7 @@ class ReportReportTestStepResponseBodyUnionMember1(BaseModel):
     truncated: bool
 
 
-class ReportReportTestStepResponseBodyUnionMember2(BaseModel):
+class ReportReportTestStepResponseBodyVulnScannerBOLABodyResponseText(BaseModel):
     """Body received as valid UTF-8 text but not valid JSON."""
 
     contents: str
@@ -149,7 +150,7 @@ class ReportReportTestStepResponseBodyUnionMember2(BaseModel):
     truncated: bool
 
 
-class ReportReportTestStepResponseBodyUnionMember3(BaseModel):
+class ReportReportTestStepResponseBodyVulnScannerBOLABodyResponseJson(BaseModel):
     """Body received as valid JSON."""
 
     contents: str
@@ -159,11 +160,14 @@ class ReportReportTestStepResponseBodyUnionMember3(BaseModel):
     truncated: bool
 
 
-ReportReportTestStepResponseBody: TypeAlias = Union[
-    ReportReportTestStepResponseBodyKind,
-    ReportReportTestStepResponseBodyUnionMember1,
-    ReportReportTestStepResponseBodyUnionMember2,
-    ReportReportTestStepResponseBodyUnionMember3,
+ReportReportTestStepResponseBody: TypeAlias = Annotated[
+    Union[
+        ReportReportTestStepResponseBodyVulnScannerBOLABodyResponseNotFound,
+        ReportReportTestStepResponseBodyVulnScannerBOLABodyResponseBytes,
+        ReportReportTestStepResponseBodyVulnScannerBOLABodyResponseText,
+        ReportReportTestStepResponseBodyVulnScannerBOLABodyResponseJson,
+    ],
+    PropertyInfo(discriminator="kind"),
 ]