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/resources/inbound-email.ts

@@ -106,8 +106,8 @@ export interface InboundEmailCreateResponse {
   allowed_sources?: Array<'cdsl' | 'nsdl' | 'cams' | 'kfintech'>;
 
   /**
-   * 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`.
    */
   callback_url?: string;
 
@@ -157,8 +157,8 @@ export interface InboundEmailRetrieveResponse {
   allowed_sources?: Array<'cdsl' | 'nsdl' | 'cams' | 'kfintech'>;
 
   /**
-   * 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`.
    */
   callback_url?: string;
 
@@ -224,8 +224,8 @@ export namespace InboundEmailListResponse {
     allowed_sources?: Array<'cdsl' | 'nsdl' | 'cams' | 'kfintech'>;
 
     /**
-     * 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`.
      */
     callback_url?: string;
 

src/resources/inbox.ts

@@ -200,8 +200,8 @@ export namespace InboxListCasFilesResponse {
      * 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)
      */
     expires_in?: number;