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-c7cca9a7a8e15f8a584c22eab142c4af72a329117f63cc3b3f7cabb25410f2ce.yml
-openapi_spec_hash: f40d936e433bbf8c98179d0b36f304c8
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cas-parser/cas-parser-0dce3ce202e44ecf2270f6ca42942cc297bbeeafddb3128f8230ba3ae85c7551.yml
+openapi_spec_hash: e9cef5743f686d9f12910c81832accca
 config_hash: 5509bb7a961ae2e79114b24c381606d4

src/cas_parser/types/inbound_email_create_response.py

@@ -18,8 +18,8 @@ class InboundEmailCreateResponse(BaseModel):
     callback_url: Optional[str] = None
     """Webhook URL for email notifications.
 
-    Empty string (`""`) means files are only retrievable via
-    `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
+    If set, we POST each parsed email here. If omitted, files are only retrievable
+    via `GET /v4/inbound-email/{id}/files`.
     """
 
     created_at: Optional[datetime] = None

src/cas_parser/types/inbound_email_list_response.py

@@ -18,8 +18,8 @@ class InboundEmail(BaseModel):
     callback_url: Optional[str] = None
     """Webhook URL for email notifications.
 
-    Empty string (`""`) means files are only retrievable via
-    `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
+    If set, we POST each parsed email here. If omitted, files are only retrievable
+    via `GET /v4/inbound-email/{id}/files`.
     """
 
     created_at: Optional[datetime] = None

src/cas_parser/types/inbound_email_retrieve_response.py

@@ -18,8 +18,8 @@ class InboundEmailRetrieveResponse(BaseModel):
     callback_url: Optional[str] = None
     """Webhook URL for email notifications.
 
-    Empty string (`""`) means files are only retrievable via
-    `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
+    If set, we POST each parsed email here. If omitted, files are only retrievable
+    via `GET /v4/inbound-email/{id}/files`.
     """
 
     created_at: Optional[datetime] = None

src/cas_parser/types/inbox_list_cas_files_response.py

@@ -19,8 +19,8 @@ class File(BaseModel):
     """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)
+    - Inbound Email with `callback_url` set: 172800 (48h)
+    - Inbound Email without `callback_url`: aligned with the session TTL (~30 min)
     """
 
     filename: Optional[str] = None