From e997de1bf4b9578656c61393865da3deb365a1db Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 2 May 2026 10:18:13 +0000
Subject: [PATCH 1/4] feat(api): api update

---
 .stats.yml                                   |  4 +-
 packages/mcp-server/src/local-docs-search.ts |  8 ++--
 src/resources/inbound-email.ts               | 42 ++++++++++----------
 src/resources/inbox.ts                       |  6 ++-
 4 files changed, 32 insertions(+), 28 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index d5b8f44..cd58596 100644
--- a/.stats.yml
+++ b/.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
diff --git a/packages/mcp-server/src/local-docs-search.ts b/packages/mcp-server/src/local-docs-search.ts
index 440c4e8..3b18479 100644
--- a/packages/mcp-server/src/local-docs-search.ts
+++ b/packages/mcp-server/src/local-docs-search.ts
@@ -844,14 +844,14 @@ const EMBEDDED_METHODS: MethodEntry[] = [
     httpMethod: 'get',
     summary: 'List Inbound Emails',
     description:
-      'List all mailboxes associated with your API key.\nReturns active and inactive mailboxes (deleted mailboxes are excluded).\n',
+      'List all inbound emails associated with your API key.\nReturns active and paused inbound emails (deleted ones are excluded).\n',
     stainlessPath: '(resource) inbound_email > (method) list',
     qualified: 'client.inboundEmail.list',
     params: ['limit?: number;', 'offset?: number;', "status?: 'active' | 'paused' | 'all';"],
     response:
       "{ inbound_emails?: { allowed_sources?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech'[]; callback_url?: string; created_at?: string; email?: string; inbound_email_id?: string; metadata?: object; reference?: string; status?: 'active' | 'paused'; updated_at?: string; }[]; limit?: number; offset?: number; status?: string; total?: number; }",
     markdown:
-      "## list\n\n`client.inboundEmail.list(limit?: number, offset?: number, status?: 'active' | 'paused' | 'all'): { inbound_emails?: object[]; limit?: number; offset?: number; status?: string; total?: number; }`\n\n**get** `/v4/inbound-email`\n\nList all mailboxes associated with your API key.\nReturns active and inactive mailboxes (deleted mailboxes are excluded).\n\n\n### Parameters\n\n- `limit?: number`\n  Maximum number of inbound emails to return\n\n- `offset?: number`\n  Pagination offset\n\n- `status?: 'active' | 'paused' | 'all'`\n  Filter by status\n\n### Returns\n\n- `{ inbound_emails?: { allowed_sources?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech'[]; callback_url?: string; created_at?: string; email?: string; inbound_email_id?: string; metadata?: object; reference?: string; status?: 'active' | 'paused'; updated_at?: string; }[]; limit?: number; offset?: number; status?: string; total?: number; }`\n\n  - `inbound_emails?: { allowed_sources?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech'[]; callback_url?: string; created_at?: string; email?: string; inbound_email_id?: string; metadata?: object; reference?: string; status?: 'active' | 'paused'; updated_at?: string; }[]`\n  - `limit?: number`\n  - `offset?: number`\n  - `status?: string`\n  - `total?: number`\n\n### Example\n\n```typescript\nimport CasParser from 'cas-parser-node';\n\nconst client = new CasParser();\n\nconst inboundEmails = await client.inboundEmail.list();\n\nconsole.log(inboundEmails);\n```",
+      "## list\n\n`client.inboundEmail.list(limit?: number, offset?: number, status?: 'active' | 'paused' | 'all'): { inbound_emails?: object[]; limit?: number; offset?: number; status?: string; total?: number; }`\n\n**get** `/v4/inbound-email`\n\nList all inbound emails associated with your API key.\nReturns active and paused inbound emails (deleted ones are excluded).\n\n\n### Parameters\n\n- `limit?: number`\n  Maximum number of inbound emails to return\n\n- `offset?: number`\n  Pagination offset\n\n- `status?: 'active' | 'paused' | 'all'`\n  Filter by status\n\n### Returns\n\n- `{ inbound_emails?: { allowed_sources?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech'[]; callback_url?: string; created_at?: string; email?: string; inbound_email_id?: string; metadata?: object; reference?: string; status?: 'active' | 'paused'; updated_at?: string; }[]; limit?: number; offset?: number; status?: string; total?: number; }`\n\n  - `inbound_emails?: { allowed_sources?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech'[]; callback_url?: string; created_at?: string; email?: string; inbound_email_id?: string; metadata?: object; reference?: string; status?: 'active' | 'paused'; updated_at?: string; }[]`\n  - `limit?: number`\n  - `offset?: number`\n  - `status?: string`\n  - `total?: number`\n\n### Example\n\n```typescript\nimport CasParser from 'cas-parser-node';\n\nconst client = new CasParser();\n\nconst inboundEmails = await client.inboundEmail.list();\n\nconsole.log(inboundEmails);\n```",
     perLanguage: {
       typescript: {
         method: 'client.inboundEmail.list',
@@ -985,14 +985,14 @@ const EMBEDDED_METHODS: MethodEntry[] = [
     endpoint: '/v4/inbound-email/{inbound_email_id}',
     httpMethod: 'get',
     summary: 'Get Inbound Email Details',
-    description: 'Retrieve details of a specific mailbox including statistics.\n',
+    description: 'Retrieve details of a specific inbound email including statistics.\n',
     stainlessPath: '(resource) inbound_email > (method) retrieve',
     qualified: 'client.inboundEmail.retrieve',
     params: ['inbound_email_id: string;'],
     response:
       "{ allowed_sources?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech'[]; callback_url?: string; created_at?: string; email?: string; inbound_email_id?: string; metadata?: object; reference?: string; status?: 'active' | 'paused'; updated_at?: string; }",
     markdown:
-      "## retrieve\n\n`client.inboundEmail.retrieve(inbound_email_id: string): { allowed_sources?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech'[]; callback_url?: string; created_at?: string; email?: string; inbound_email_id?: string; metadata?: object; reference?: string; status?: 'active' | 'paused'; updated_at?: string; }`\n\n**get** `/v4/inbound-email/{inbound_email_id}`\n\nRetrieve details of a specific mailbox including statistics.\n\n\n### Parameters\n\n- `inbound_email_id: string`\n\n### Returns\n\n- `{ allowed_sources?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech'[]; callback_url?: string; created_at?: string; email?: string; inbound_email_id?: string; metadata?: object; reference?: string; status?: 'active' | 'paused'; updated_at?: string; }`\n  An inbound email address for receiving forwarded CAS emails\n\n  - `allowed_sources?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech'[]`\n  - `callback_url?: string`\n  - `created_at?: string`\n  - `email?: string`\n  - `inbound_email_id?: string`\n  - `metadata?: object`\n  - `reference?: string`\n  - `status?: 'active' | 'paused'`\n  - `updated_at?: string`\n\n### Example\n\n```typescript\nimport CasParser from 'cas-parser-node';\n\nconst client = new CasParser();\n\nconst inboundEmail = await client.inboundEmail.retrieve('inbound_email_id');\n\nconsole.log(inboundEmail);\n```",
+      "## retrieve\n\n`client.inboundEmail.retrieve(inbound_email_id: string): { allowed_sources?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech'[]; callback_url?: string; created_at?: string; email?: string; inbound_email_id?: string; metadata?: object; reference?: string; status?: 'active' | 'paused'; updated_at?: string; }`\n\n**get** `/v4/inbound-email/{inbound_email_id}`\n\nRetrieve details of a specific inbound email including statistics.\n\n\n### Parameters\n\n- `inbound_email_id: string`\n\n### Returns\n\n- `{ allowed_sources?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech'[]; callback_url?: string; created_at?: string; email?: string; inbound_email_id?: string; metadata?: object; reference?: string; status?: 'active' | 'paused'; updated_at?: string; }`\n  An inbound email address for receiving forwarded CAS emails\n\n  - `allowed_sources?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech'[]`\n  - `callback_url?: string`\n  - `created_at?: string`\n  - `email?: string`\n  - `inbound_email_id?: string`\n  - `metadata?: object`\n  - `reference?: string`\n  - `status?: 'active' | 'paused'`\n  - `updated_at?: string`\n\n### Example\n\n```typescript\nimport CasParser from 'cas-parser-node';\n\nconst client = new CasParser();\n\nconst inboundEmail = await client.inboundEmail.retrieve('inbound_email_id');\n\nconsole.log(inboundEmail);\n```",
     perLanguage: {
       typescript: {
         method: 'client.inboundEmail.retrieve',
diff --git a/src/resources/inbound-email.ts b/src/resources/inbound-email.ts
index fdb76b9..cdebc5e 100644
--- a/src/resources/inbound-email.ts
+++ b/src/resources/inbound-email.ts
@@ -49,7 +49,7 @@ export class InboundEmail extends APIResource {
   }
 
   /**
-   * Retrieve details of a specific mailbox including statistics.
+   * Retrieve details of a specific inbound email including statistics.
    *
    * @example
    * ```ts
@@ -63,8 +63,8 @@ export class InboundEmail extends APIResource {
   }
 
   /**
-   * List all mailboxes associated with your API key. Returns active and inactive
-   * mailboxes (deleted mailboxes are excluded).
+   * List all inbound emails associated with your API key. Returns active and paused
+   * inbound emails (deleted ones are excluded).
    *
    * @example
    * ```ts
@@ -106,13 +106,13 @@ export interface InboundEmailCreateResponse {
   allowed_sources?: Array<'cdsl' | 'nsdl' | 'cams' | 'kfintech'>;
 
   /**
-   * Webhook URL for email notifications. `null` means files are only retrievable via
-   * `GET /v4/inbound-email/{id}/files` (pull delivery).
+   * Webhook URL for email notifications. Empty string (`""`) means files are only
+   * retrievable via `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
    */
-  callback_url?: string | null;
+  callback_url?: string;
 
   /**
-   * When the mailbox was created
+   * When the inbound email was created
    */
   created_at?: string;
 
@@ -137,12 +137,12 @@ export interface InboundEmailCreateResponse {
   reference?: string | null;
 
   /**
-   * Current mailbox status
+   * Current inbound email lifecycle status
    */
   status?: 'active' | 'paused';
 
   /**
-   * When the mailbox was last updated
+   * When the inbound email was last updated
    */
   updated_at?: string;
 }
@@ -157,13 +157,13 @@ export interface InboundEmailRetrieveResponse {
   allowed_sources?: Array<'cdsl' | 'nsdl' | 'cams' | 'kfintech'>;
 
   /**
-   * Webhook URL for email notifications. `null` means files are only retrievable via
-   * `GET /v4/inbound-email/{id}/files` (pull delivery).
+   * Webhook URL for email notifications. Empty string (`""`) means files are only
+   * retrievable via `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
    */
-  callback_url?: string | null;
+  callback_url?: string;
 
   /**
-   * When the mailbox was created
+   * When the inbound email was created
    */
   created_at?: string;
 
@@ -188,12 +188,12 @@ export interface InboundEmailRetrieveResponse {
   reference?: string | null;
 
   /**
-   * Current mailbox status
+   * Current inbound email lifecycle status
    */
   status?: 'active' | 'paused';
 
   /**
-   * When the mailbox was last updated
+   * When the inbound email was last updated
    */
   updated_at?: string;
 }
@@ -224,13 +224,13 @@ export namespace InboundEmailListResponse {
     allowed_sources?: Array<'cdsl' | 'nsdl' | 'cams' | 'kfintech'>;
 
     /**
-     * Webhook URL for email notifications. `null` means files are only retrievable via
-     * `GET /v4/inbound-email/{id}/files` (pull delivery).
+     * Webhook URL for email notifications. Empty string (`""`) means files are only
+     * retrievable via `GET /v4/inbound-email/{id}/files` (SDK / pull mode).
      */
-    callback_url?: string | null;
+    callback_url?: string;
 
     /**
-     * When the mailbox was created
+     * When the inbound email was created
      */
     created_at?: string;
 
@@ -255,12 +255,12 @@ export namespace InboundEmailListResponse {
     reference?: string | null;
 
     /**
-     * Current mailbox status
+     * Current inbound email lifecycle status
      */
     status?: 'active' | 'paused';
 
     /**
-     * When the mailbox was last updated
+     * When the inbound email was last updated
      */
     updated_at?: string;
   }
diff --git a/src/resources/inbox.ts b/src/resources/inbox.ts
index b2b36ca..6482938 100644
--- a/src/resources/inbox.ts
+++ b/src/resources/inbox.ts
@@ -197,7 +197,11 @@ export namespace InboxListCasFilesResponse {
     cas_type?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech';
 
     /**
-     * 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)
      */
     expires_in?: number;
 

From 0116ca5490a4dcc51738a366f5664cdb6c6ee973 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 2 May 2026 11:18:18 +0000
Subject: [PATCH 2/4] feat(api): api update

---
 .stats.yml                     |  4 ++--
 src/resources/inbound-email.ts | 12 ++++++------
 src/resources/inbox.ts         |  4 ++--
 3 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index cd58596..d224bd8 100644
--- a/.stats.yml
+++ b/.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
diff --git a/src/resources/inbound-email.ts b/src/resources/inbound-email.ts
index cdebc5e..1d74d04 100644
--- a/src/resources/inbound-email.ts
+++ b/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;
 
diff --git a/src/resources/inbox.ts b/src/resources/inbox.ts
index 6482938..ba844e6 100644
--- a/src/resources/inbox.ts
+++ b/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;
 

From 8c6c873bbeec810d0a5b3bb584f6a401bf75417c Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 2 May 2026 23:18:18 +0000
Subject: [PATCH 3/4] codegen metadata

---
 .stats.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index d224bd8..582a92c 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 21
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cas-parser/cas-parser-0dce3ce202e44ecf2270f6ca42942cc297bbeeafddb3128f8230ba3ae85c7551.yml
-openapi_spec_hash: e9cef5743f686d9f12910c81832accca
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cas-parser/cas-parser-e572d88c2af6e4d7bc4f7e119357fd3f68b1e67d612fd1d3a657d916cde0087c.yml
+openapi_spec_hash: a9fc7d947111bffa9184f8ca8be4a579
 config_hash: 5509bb7a961ae2e79114b24c381606d4

From d30ce0a3ef7f36b10b6760fd5bf0d93a52a9ddba Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 2 May 2026 23:18:38 +0000
Subject: [PATCH 4/4] release: 1.13.0

---
 .release-please-manifest.json     | 2 +-
 CHANGELOG.md                      | 9 +++++++++
 package.json                      | 2 +-
 packages/mcp-server/manifest.json | 2 +-
 packages/mcp-server/package.json  | 2 +-
 packages/mcp-server/src/server.ts | 2 +-
 src/version.ts                    | 2 +-
 7 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index a09efe7..23860f9 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "1.12.0"
+  ".": "1.13.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4f08931..d1cbf37 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.13.0 (2026-05-02)
+
+Full Changelog: [v1.12.0...v1.13.0](https://github.com/CASParser/cas-parser-node/compare/v1.12.0...v1.13.0)
+
+### Features
+
+* **api:** api update ([0116ca5](https://github.com/CASParser/cas-parser-node/commit/0116ca5490a4dcc51738a366f5664cdb6c6ee973))
+* **api:** api update ([e997de1](https://github.com/CASParser/cas-parser-node/commit/e997de1bf4b9578656c61393865da3deb365a1db))
+
 ## 1.12.0 (2026-05-01)
 
 Full Changelog: [v1.11.0...v1.12.0](https://github.com/CASParser/cas-parser-node/compare/v1.11.0...v1.12.0)
diff --git a/package.json b/package.json
index e9e9f02..f5f20b6 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cas-parser-node",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "The official TypeScript library for the Cas Parser API",
   "author": "Cas Parser <sameer@casparser.in>",
   "types": "dist/index.d.ts",
diff --git a/packages/mcp-server/manifest.json b/packages/mcp-server/manifest.json
index 00b44a4..bfae606 100644
--- a/packages/mcp-server/manifest.json
+++ b/packages/mcp-server/manifest.json
@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "cas-parser-node-mcp",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "The official MCP Server for the Cas Parser API",
   "author": {
     "name": "Cas Parser",
diff --git a/packages/mcp-server/package.json b/packages/mcp-server/package.json
index 5ea26ff..92fd7e7 100644
--- a/packages/mcp-server/package.json
+++ b/packages/mcp-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cas-parser-node-mcp",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "The official MCP Server for the Cas Parser API",
   "author": "Cas Parser <sameer@casparser.in>",
   "types": "dist/index.d.ts",
diff --git a/packages/mcp-server/src/server.ts b/packages/mcp-server/src/server.ts
index 285b66b..1888af6 100644
--- a/packages/mcp-server/src/server.ts
+++ b/packages/mcp-server/src/server.ts
@@ -28,7 +28,7 @@ export const newMcpServer = async ({
   new McpServer(
     {
       name: 'cas_parser_node_api',
-      version: '1.12.0',
+      version: '1.13.0',
     },
     {
       instructions: await getInstructions({ stainlessApiKey, customInstructionsPath }),
diff --git a/src/version.ts b/src/version.ts
index f73650e..287b358 100644
--- a/src/version.ts
+++ b/src/version.ts
@@ -1 +1 @@
-export const VERSION = '1.12.0'; // x-release-please-version
+export const VERSION = '1.13.0'; // x-release-please-version