feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 21
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cas-parser/cas-parser-2fd773786951b723a5d7d7342bf1c6ab46f08bd2851e916d188faae379d5aa4c.yml
-openapi_spec_hash: 7515d1e5fe3130b9f5411f7aacbc8a64
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cas-parser/cas-parser-c7cca9a7a8e15f8a584c22eab142c4af72a329117f63cc3b3f7cabb25410f2ce.yml
+openapi_spec_hash: f40d936e433bbf8c98179d0b36f304c8
 config_hash: 5509bb7a961ae2e79114b24c381606d4

src/cas_parser/resources/inbound_email.py

@@ -156,7 +156,7 @@ def retrieve(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InboundEmailRetrieveResponse:
         """
-        Retrieve details of a specific mailbox including statistics.
+        Retrieve details of a specific inbound email including statistics.
 
         Args:
           extra_headers: Send extra headers
@@ -190,10 +190,10 @@ def list(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InboundEmailListResponse:
-        """List all mailboxes associated with your API key.
+        """List all inbound emails associated with your API key.
 
-        Returns active and inactive
-        mailboxes (deleted mailboxes are excluded).
+        Returns active and paused
+        inbound emails (deleted ones are excluded).
 
         Args:
           limit: Maximum number of inbound emails to return
@@ -396,7 +396,7 @@ async def retrieve(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InboundEmailRetrieveResponse:
         """
-        Retrieve details of a specific mailbox including statistics.
+        Retrieve details of a specific inbound email including statistics.
 
         Args:
           extra_headers: Send extra headers
@@ -430,10 +430,10 @@ async def list(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InboundEmailListResponse:
-        """List all mailboxes associated with your API key.
+        """List all inbound emails associated with your API key.
 
-        Returns active and inactive
-        mailboxes (deleted mailboxes are excluded).
+        Returns active and paused
+        inbound emails (deleted ones are excluded).
 
         Args:
           limit: Maximum number of inbound emails to return

src/cas_parser/types/inbound_email_create_response.py

@@ -18,12 +18,12 @@ class InboundEmailCreateResponse(BaseModel):
     callback_url: Optional[str] = None
     """Webhook URL for email notifications.
 
-    `null` means files are only retrievable via `GET /v4/inbound-email/{id}/files`
-    (pull delivery).
+    Empty string (`""`) means files are only retrievable via
+    `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
     """
 
     created_at: Optional[datetime] = None
-    """When the mailbox was created"""
+    """When the inbound email was created"""
 
     email: Optional[str] = None
     """The inbound email address to forward CAS statements to"""
@@ -38,7 +38,7 @@ class InboundEmailCreateResponse(BaseModel):
     """Your internal reference identifier"""
 
     status: Optional[Literal["active", "paused"]] = None
-    """Current mailbox status"""
+    """Current inbound email lifecycle status"""
 
     updated_at: Optional[datetime] = None
-    """When the mailbox was last updated"""
+    """When the inbound email was last updated"""

src/cas_parser/types/inbound_email_list_response.py

@@ -18,12 +18,12 @@ class InboundEmail(BaseModel):
     callback_url: Optional[str] = None
     """Webhook URL for email notifications.
 
-    `null` means files are only retrievable via `GET /v4/inbound-email/{id}/files`
-    (pull delivery).
+    Empty string (`""`) means files are only retrievable via
+    `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
     """
 
     created_at: Optional[datetime] = None
-    """When the mailbox was created"""
+    """When the inbound email was created"""
 
     email: Optional[str] = None
     """The inbound email address to forward CAS statements to"""
@@ -38,10 +38,10 @@ class InboundEmail(BaseModel):
     """Your internal reference identifier"""
 
     status: Optional[Literal["active", "paused"]] = None
-    """Current mailbox status"""
+    """Current inbound email lifecycle status"""
 
     updated_at: Optional[datetime] = None
-    """When the mailbox was last updated"""
+    """When the inbound email was last updated"""
 
 
 class InboundEmailListResponse(BaseModel):

src/cas_parser/types/inbound_email_retrieve_response.py

@@ -18,12 +18,12 @@ class InboundEmailRetrieveResponse(BaseModel):
     callback_url: Optional[str] = None
     """Webhook URL for email notifications.
 
-    `null` means files are only retrievable via `GET /v4/inbound-email/{id}/files`
-    (pull delivery).
+    Empty string (`""`) means files are only retrievable via
+    `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
     """
 
     created_at: Optional[datetime] = None
-    """When the mailbox was created"""
+    """When the inbound email was created"""
 
     email: Optional[str] = None
     """The inbound email address to forward CAS statements to"""
@@ -38,7 +38,7 @@ class InboundEmailRetrieveResponse(BaseModel):
     """Your internal reference identifier"""
 
     status: Optional[Literal["active", "paused"]] = None
-    """Current mailbox status"""
+    """Current inbound email lifecycle status"""
 
     updated_at: Optional[datetime] = None
-    """When the mailbox was last updated"""
+    """When the inbound email was last updated"""

src/cas_parser/types/inbox_list_cas_files_response.py

@@ -16,7 +16,12 @@ class File(BaseModel):
     """Detected CAS provider based on sender email"""
 
     expires_in: Optional[int] = None
-    """URL expiration time in seconds (default 86400 = 24 hours)"""
+    """URL expiration time in seconds. Defaults vary by source:
+
+    - Gmail Inbox Import: 86400 (24h)
+    - Inbound Email (webhook mode): 172800 (48h)
+    - Inbound Email (SDK mode): aligned with the session TTL (~30 min)
+    """
 
     filename: Optional[str] = None
     """Standardized filename (provider_YYYYMMDD_uniqueid.pdf)"""