agentmail 0.5.17 → 0.5.19

package/dist/cjs/api/resources/webhooks/types/UpdateWebhookHeadersRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/webhooks/types/WebhookHeaderNamesResponse.d.ts

@@ -0,0 +1,4 @@
+export interface WebhookHeaderNamesResponse {
+    /** Names of the custom delivery headers configured for this webhook. Header values are never returned. */
+    headerNames: string[];
+}

package/dist/cjs/api/resources/webhooks/types/WebhookHeaderNamesResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/webhooks/types/WebhookHeaders.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Custom HTTP headers to include with every delivery to this webhook. Header values are write-only:
+ * AgentMail never returns them from webhook read endpoints. The map must contain at least one entry
+ * when provided, and every name and value must be a valid HTTP header.
+ */
+export type WebhookHeaders = Record<string, string>;

package/dist/cjs/api/resources/webhooks/types/WebhookHeaders.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/webhooks/types/index.d.ts

@@ -7,7 +7,10 @@ export * from "./ListWebhooksResponse.js";
 export * from "./UpdateInboxWebhookRequest.js";
 export * from "./UpdatePodWebhookRequest.js";
 export * from "./UpdateWebhookEventTypes.js";
+export * from "./UpdateWebhookHeadersRequest.js";
 export * from "./UpdateWebhookRequest.js";
 export * from "./Url.js";
 export * from "./Webhook.js";
+export * from "./WebhookHeaderNamesResponse.js";
+export * from "./WebhookHeaders.js";
 export * from "./WebhookId.js";

package/dist/cjs/api/resources/webhooks/types/index.js

@@ -23,7 +23,10 @@ __exportStar(require("./ListWebhooksResponse.js"), exports);
 __exportStar(require("./UpdateInboxWebhookRequest.js"), exports);
 __exportStar(require("./UpdatePodWebhookRequest.js"), exports);
 __exportStar(require("./UpdateWebhookEventTypes.js"), exports);
+__exportStar(require("./UpdateWebhookHeadersRequest.js"), exports);
 __exportStar(require("./UpdateWebhookRequest.js"), exports);
 __exportStar(require("./Url.js"), exports);
 __exportStar(require("./Webhook.js"), exports);
+__exportStar(require("./WebhookHeaderNamesResponse.js"), exports);
+__exportStar(require("./WebhookHeaders.js"), exports);
 __exportStar(require("./WebhookId.js"), exports);

package/dist/cjs/serialization/resources/apiKeys/types/ApiKeyPermissions.d.ts

@@ -8,13 +8,13 @@ export declare namespace ApiKeyPermissions {
         inbox_create?: boolean | null;
         inbox_update?: boolean | null;
         inbox_delete?: boolean | null;
-        thread_read?: boolean | null;
-        thread_delete?: boolean | null;
         message_read?: boolean | null;
         message_send?: boolean | null;
         message_update?: boolean | null;
+        message_delete?: boolean | null;
         label_spam_read?: boolean | null;
         label_blocked_read?: boolean | null;
+        label_unauthenticated_read?: boolean | null;
         label_trash_read?: boolean | null;
         draft_read?: boolean | null;
         draft_create?: boolean | null;

package/dist/cjs/serialization/resources/apiKeys/types/ApiKeyPermissions.js

@@ -41,13 +41,13 @@ exports.ApiKeyPermissions = core.serialization.object({
     inboxCreate: core.serialization.property("inbox_create", core.serialization.boolean().optional()),
     inboxUpdate: core.serialization.property("inbox_update", core.serialization.boolean().optional()),
     inboxDelete: core.serialization.property("inbox_delete", core.serialization.boolean().optional()),
-    threadRead: core.serialization.property("thread_read", core.serialization.boolean().optional()),
-    threadDelete: core.serialization.property("thread_delete", core.serialization.boolean().optional()),
     messageRead: core.serialization.property("message_read", core.serialization.boolean().optional()),
     messageSend: core.serialization.property("message_send", core.serialization.boolean().optional()),
     messageUpdate: core.serialization.property("message_update", core.serialization.boolean().optional()),
+    messageDelete: core.serialization.property("message_delete", core.serialization.boolean().optional()),
     labelSpamRead: core.serialization.property("label_spam_read", core.serialization.boolean().optional()),
     labelBlockedRead: core.serialization.property("label_blocked_read", core.serialization.boolean().optional()),
+    labelUnauthenticatedRead: core.serialization.property("label_unauthenticated_read", core.serialization.boolean().optional()),
     labelTrashRead: core.serialization.property("label_trash_read", core.serialization.boolean().optional()),
     draftRead: core.serialization.property("draft_read", core.serialization.boolean().optional()),
     draftCreate: core.serialization.property("draft_create", core.serialization.boolean().optional()),

package/dist/cjs/serialization/resources/webhooks/types/CreateInboxWebhookRequest.d.ts

@@ -4,11 +4,13 @@ import type * as serializers from "../../../index.js";
 import { ClientId } from "./ClientId.js";
 import { CreateWebhookEventTypes } from "./CreateWebhookEventTypes.js";
 import { Url } from "./Url.js";
+import { WebhookHeaders } from "./WebhookHeaders.js";
 export declare const CreateInboxWebhookRequest: core.serialization.ObjectSchema<serializers.webhooks.CreateInboxWebhookRequest.Raw, AgentMail.webhooks.CreateInboxWebhookRequest>;
 export declare namespace CreateInboxWebhookRequest {
     interface Raw {
         url: Url.Raw;
         event_types: CreateWebhookEventTypes.Raw;
         client_id?: ClientId.Raw | null;
+        headers?: WebhookHeaders.Raw | null;
     }
 }

package/dist/cjs/serialization/resources/webhooks/types/CreateInboxWebhookRequest.js

@@ -39,8 +39,10 @@ const core = __importStar(require("../../../../core/index.js"));
 const ClientId_js_1 = require("./ClientId.js");
 const CreateWebhookEventTypes_js_1 = require("./CreateWebhookEventTypes.js");
 const Url_js_1 = require("./Url.js");
+const WebhookHeaders_js_1 = require("./WebhookHeaders.js");
 exports.CreateInboxWebhookRequest = core.serialization.object({
     url: Url_js_1.Url,
     eventTypes: core.serialization.property("event_types", CreateWebhookEventTypes_js_1.CreateWebhookEventTypes),
     clientId: core.serialization.property("client_id", ClientId_js_1.ClientId.optional()),
+    headers: WebhookHeaders_js_1.WebhookHeaders.optional(),
 });

package/dist/cjs/serialization/resources/webhooks/types/UpdateWebhookHeadersRequest.d.ts

@@ -0,0 +1,11 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+import { WebhookHeaders } from "./WebhookHeaders.js";
+export declare const UpdateWebhookHeadersRequest: core.serialization.ObjectSchema<serializers.webhooks.UpdateWebhookHeadersRequest.Raw, AgentMail.webhooks.UpdateWebhookHeadersRequest>;
+export declare namespace UpdateWebhookHeadersRequest {
+    interface Raw {
+        headers?: WebhookHeaders.Raw | null;
+        remove_headers?: string[] | null;
+    }
+}

package/dist/cjs/serialization/resources/webhooks/types/UpdateWebhookHeadersRequest.js

@@ -0,0 +1,43 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateWebhookHeadersRequest = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+const WebhookHeaders_js_1 = require("./WebhookHeaders.js");
+exports.UpdateWebhookHeadersRequest = core.serialization.object({
+    headers: WebhookHeaders_js_1.WebhookHeaders.optional(),
+    removeHeaders: core.serialization.property("remove_headers", core.serialization.list(core.serialization.string()).optional()),
+});

package/dist/cjs/serialization/resources/webhooks/types/WebhookHeaderNamesResponse.d.ts

@@ -0,0 +1,9 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+export declare const WebhookHeaderNamesResponse: core.serialization.ObjectSchema<serializers.webhooks.WebhookHeaderNamesResponse.Raw, AgentMail.webhooks.WebhookHeaderNamesResponse>;
+export declare namespace WebhookHeaderNamesResponse {
+    interface Raw {
+        header_names: string[];
+    }
+}

package/dist/cjs/serialization/resources/webhooks/types/WebhookHeaderNamesResponse.js

@@ -0,0 +1,41 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookHeaderNamesResponse = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+exports.WebhookHeaderNamesResponse = core.serialization.object({
+    headerNames: core.serialization.property("header_names", core.serialization.list(core.serialization.string())),
+});

package/dist/cjs/serialization/resources/webhooks/types/WebhookHeaders.d.ts

@@ -0,0 +1,7 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+export declare const WebhookHeaders: core.serialization.Schema<serializers.webhooks.WebhookHeaders.Raw, AgentMail.webhooks.WebhookHeaders>;
+export declare namespace WebhookHeaders {
+    type Raw = Record<string, string>;
+}

package/dist/cjs/serialization/resources/webhooks/types/WebhookHeaders.js

@@ -0,0 +1,39 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookHeaders = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+exports.WebhookHeaders = core.serialization.record(core.serialization.string(), core.serialization.string());

package/dist/cjs/serialization/resources/webhooks/types/index.d.ts

@@ -7,7 +7,10 @@ export * from "./ListWebhooksResponse.js";
 export * from "./UpdateInboxWebhookRequest.js";
 export * from "./UpdatePodWebhookRequest.js";
 export * from "./UpdateWebhookEventTypes.js";
+export * from "./UpdateWebhookHeadersRequest.js";
 export * from "./UpdateWebhookRequest.js";
 export * from "./Url.js";
 export * from "./Webhook.js";
+export * from "./WebhookHeaderNamesResponse.js";
+export * from "./WebhookHeaders.js";
 export * from "./WebhookId.js";

package/dist/cjs/serialization/resources/webhooks/types/index.js

@@ -23,7 +23,10 @@ __exportStar(require("./ListWebhooksResponse.js"), exports);
 __exportStar(require("./UpdateInboxWebhookRequest.js"), exports);
 __exportStar(require("./UpdatePodWebhookRequest.js"), exports);
 __exportStar(require("./UpdateWebhookEventTypes.js"), exports);
+__exportStar(require("./UpdateWebhookHeadersRequest.js"), exports);
 __exportStar(require("./UpdateWebhookRequest.js"), exports);
 __exportStar(require("./Url.js"), exports);
 __exportStar(require("./Webhook.js"), exports);
+__exportStar(require("./WebhookHeaderNamesResponse.js"), exports);
+__exportStar(require("./WebhookHeaders.js"), exports);
 __exportStar(require("./WebhookId.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.17";
+export declare const SDK_VERSION = "0.5.19";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.5.17";
+exports.SDK_VERSION = "0.5.19";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "agentmail",
-        "X-Fern-SDK-Version": "0.5.17",
-        "User-Agent": "agentmail/0.5.17",
+        "X-Fern-SDK-Version": "0.5.19",
+        "User-Agent": "agentmail/0.5.19",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/api/resources/apiKeys/types/ApiKeyPermissions.d.mts

@@ -10,20 +10,20 @@ export interface ApiKeyPermissions {
     inboxUpdate?: boolean;
     /** Delete inboxes. */
     inboxDelete?: boolean;
-    /** Read threads. */
-    threadRead?: boolean;
-    /** Delete threads. */
-    threadDelete?: boolean;
-    /** Read messages. */
+    /** Read messages. Also required to read threads. */
     messageRead?: boolean;
     /** Send messages. */
     messageSend?: boolean;
-    /** Update message labels. */
+    /** Update message labels. Also required to update threads. */
     messageUpdate?: boolean;
+    /** Delete messages. Also required to delete threads. */
+    messageDelete?: boolean;
     /** Access messages labeled spam. */
     labelSpamRead?: boolean;
     /** Access messages labeled blocked. */
     labelBlockedRead?: boolean;
+    /** Access messages labeled unauthenticated. */
+    labelUnauthenticatedRead?: boolean;
     /** Access messages labeled trash. */
     labelTrashRead?: boolean;
     /** Read drafts. */

package/dist/esm/api/resources/inboxes/resources/webhooks/client/Client.d.mts

@@ -42,6 +42,21 @@ export declare class WebhooksClient {
      */
     get(inbox_id: AgentMail.inboxes.InboxId, webhook_id: AgentMail.webhooks.WebhookId, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<AgentMail.webhooks.Webhook>;
     private __get;
+    /**
+     * List the names of custom HTTP headers included with deliveries to this inbox-scoped webhook.
+     * Header values are write-only and are never returned.
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.webhooks.WebhookId} webhook_id
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.webhooks.getHeaders("inbox_id", "webhook_id")
+     */
+    getHeaders(inbox_id: AgentMail.inboxes.InboxId, webhook_id: AgentMail.webhooks.WebhookId, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<AgentMail.webhooks.WebhookHeaderNamesResponse>;
+    private __getHeaders;
     /**
      * Create a webhook scoped to this inbox.
      *
@@ -83,6 +98,23 @@ export declare class WebhooksClient {
      */
     update(inbox_id: AgentMail.inboxes.InboxId, webhook_id: AgentMail.webhooks.WebhookId, request: AgentMail.webhooks.UpdateInboxWebhookRequest, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<AgentMail.webhooks.Webhook>;
     private __update;
+    /**
+     * Atomically set, replace, or remove custom HTTP headers included with deliveries to this
+     * inbox-scoped webhook. Header values remain write-only.
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.webhooks.WebhookId} webhook_id
+     * @param {AgentMail.webhooks.UpdateWebhookHeadersRequest} request
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.webhooks.updateHeaders("inbox_id", "webhook_id", {})
+     */
+    updateHeaders(inbox_id: AgentMail.inboxes.InboxId, webhook_id: AgentMail.webhooks.WebhookId, request: AgentMail.webhooks.UpdateWebhookHeadersRequest, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<void>;
+    private __updateHeaders;
     /**
      * **CLI:**
      * ```bash

package/dist/esm/api/resources/inboxes/resources/webhooks/client/Client.mjs

@@ -149,6 +149,72 @@ export class WebhooksClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v0/inboxes/{inbox_id}/webhooks/{webhook_id}");
         });
     }
+    /**
+     * List the names of custom HTTP headers included with deliveries to this inbox-scoped webhook.
+     * Header values are write-only and are never returned.
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.webhooks.WebhookId} webhook_id
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.webhooks.getHeaders("inbox_id", "webhook_id")
+     */
+    getHeaders(inbox_id, webhook_id, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getHeaders(inbox_id, webhook_id, requestOptions));
+    }
+    __getHeaders(inbox_id, webhook_id, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Prod)
+                    .http, `/v0/inboxes/${core.url.encodePathParam(serializers.inboxes.InboxId.jsonOrThrow(inbox_id, { omitUndefined: true }))}/webhooks/${core.url.encodePathParam(serializers.webhooks.WebhookId.jsonOrThrow(webhook_id, { omitUndefined: true }))}/headers`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.webhooks.WebhookHeaderNamesResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AgentMail.NotFoundError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v0/inboxes/{inbox_id}/webhooks/{webhook_id}/headers");
+        });
+    }
     /**
      * Create a webhook scoped to this inbox.
      *
@@ -312,6 +378,79 @@ export class WebhooksClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "PATCH", "/v0/inboxes/{inbox_id}/webhooks/{webhook_id}");
         });
     }
+    /**
+     * Atomically set, replace, or remove custom HTTP headers included with deliveries to this
+     * inbox-scoped webhook. Header values remain write-only.
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.webhooks.WebhookId} webhook_id
+     * @param {AgentMail.webhooks.UpdateWebhookHeadersRequest} request
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.webhooks.updateHeaders("inbox_id", "webhook_id", {})
+     */
+    updateHeaders(inbox_id, webhook_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__updateHeaders(inbox_id, webhook_id, request, requestOptions));
+    }
+    __updateHeaders(inbox_id, webhook_id, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Prod)
+                    .http, `/v0/inboxes/${core.url.encodePathParam(serializers.inboxes.InboxId.jsonOrThrow(inbox_id, { omitUndefined: true }))}/webhooks/${core.url.encodePathParam(serializers.webhooks.WebhookId.jsonOrThrow(webhook_id, { omitUndefined: true }))}/headers`),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.webhooks.UpdateWebhookHeadersRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: undefined, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AgentMail.NotFoundError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "PATCH", "/v0/inboxes/{inbox_id}/webhooks/{webhook_id}/headers");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

package/dist/esm/api/resources/pods/resources/webhooks/client/Client.d.mts

@@ -42,6 +42,21 @@ export declare class WebhooksClient {
      */
     get(pod_id: AgentMail.pods.PodId, webhook_id: AgentMail.webhooks.WebhookId, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<AgentMail.webhooks.Webhook>;
     private __get;
+    /**
+     * List the names of custom HTTP headers included with deliveries to this pod-scoped webhook.
+     * Header values are write-only and are never returned.
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.webhooks.WebhookId} webhook_id
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.pods.webhooks.getHeaders("pod_id", "webhook_id")
+     */
+    getHeaders(pod_id: AgentMail.pods.PodId, webhook_id: AgentMail.webhooks.WebhookId, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<AgentMail.webhooks.WebhookHeaderNamesResponse>;
+    private __getHeaders;
     /**
      * Create a webhook scoped to this pod.
      *
@@ -83,6 +98,23 @@ export declare class WebhooksClient {
      */
     update(pod_id: AgentMail.pods.PodId, webhook_id: AgentMail.webhooks.WebhookId, request: AgentMail.webhooks.UpdatePodWebhookRequest, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<AgentMail.webhooks.Webhook>;
     private __update;
+    /**
+     * Atomically set, replace, or remove custom HTTP headers included with deliveries to this
+     * pod-scoped webhook. Header values remain write-only.
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.webhooks.WebhookId} webhook_id
+     * @param {AgentMail.webhooks.UpdateWebhookHeadersRequest} request
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.pods.webhooks.updateHeaders("pod_id", "webhook_id", {})
+     */
+    updateHeaders(pod_id: AgentMail.pods.PodId, webhook_id: AgentMail.webhooks.WebhookId, request: AgentMail.webhooks.UpdateWebhookHeadersRequest, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<void>;
+    private __updateHeaders;
     /**
      * **CLI:**
      * ```bash