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/InboundEmail/InboundEmailGetResponse.php

@@ -39,8 +39,9 @@ final class InboundEmailGetResponse implements BaseModel
     public ?array $allowedSources;
 
     /**
-     * Webhook URL for email notifications. Empty string (`""`) means files are
-     * only retrievable via `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
+     * Webhook URL for email notifications. If set, we POST each parsed
+     * email here. If omitted, files are only retrievable via
+     * `GET /v4/inbound-email/{id}/files`.
      */
     #[Optional('callback_url')]
     public ?string $callbackURL;
@@ -145,8 +146,9 @@ public function withAllowedSources(array $allowedSources): self
     }
 
     /**
-     * Webhook URL for email notifications. Empty string (`""`) means files are
-     * only retrievable via `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
+     * Webhook URL for email notifications. If set, we POST each parsed
+     * email here. If omitted, files are only retrievable via
+     * `GET /v4/inbound-email/{id}/files`.
      */
     public function withCallbackURL(string $callbackURL): self
     {

src/InboundEmail/InboundEmailListResponse/InboundEmail.php

@@ -39,8 +39,9 @@ final class InboundEmail implements BaseModel
     public ?array $allowedSources;
 
     /**
-     * Webhook URL for email notifications. Empty string (`""`) means files are
-     * only retrievable via `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
+     * Webhook URL for email notifications. If set, we POST each parsed
+     * email here. If omitted, files are only retrievable via
+     * `GET /v4/inbound-email/{id}/files`.
      */
     #[Optional('callback_url')]
     public ?string $callbackURL;
@@ -145,8 +146,9 @@ public function withAllowedSources(array $allowedSources): self
     }
 
     /**
-     * Webhook URL for email notifications. Empty string (`""`) means files are
-     * only retrievable via `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
+     * Webhook URL for email notifications. If set, we POST each parsed
+     * email here. If omitted, files are only retrievable via
+     * `GET /v4/inbound-email/{id}/files`.
      */
     public function withCallbackURL(string $callbackURL): self
     {

src/InboundEmail/InboundEmailNewResponse.php

@@ -39,8 +39,9 @@ final class InboundEmailNewResponse implements BaseModel
     public ?array $allowedSources;
 
     /**
-     * Webhook URL for email notifications. Empty string (`""`) means files are
-     * only retrievable via `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
+     * Webhook URL for email notifications. If set, we POST each parsed
+     * email here. If omitted, files are only retrievable via
+     * `GET /v4/inbound-email/{id}/files`.
      */
     #[Optional('callback_url')]
     public ?string $callbackURL;
@@ -145,8 +146,9 @@ public function withAllowedSources(array $allowedSources): self
     }
 
     /**
-     * Webhook URL for email notifications. Empty string (`""`) means files are
-     * only retrievable via `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
+     * Webhook URL for email notifications. If set, we POST each parsed
+     * email here. If omitted, files are only retrievable via
+     * `GET /v4/inbound-email/{id}/files`.
      */
     public function withCallbackURL(string $callbackURL): self
     {

src/Inbox/InboxListCasFilesResponse/File.php

@@ -40,8 +40,8 @@ final class File implements 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)
      */
     #[Optional('expires_in')]
     public ?int $expiresIn;
@@ -142,8 +142,8 @@ public function withCasType(CasType|string $casType): self
     /**
      * 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)
      */
     public function withExpiresIn(int $expiresIn): self
     {