agentmail 0.5.10 → 0.5.11

package/dist/cjs/BaseClient.js

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

package/dist/cjs/api/resources/inboxes/resources/messages/client/Client.d.ts

@@ -93,6 +93,32 @@ export declare class MessagesClient {
      */
     batchGet(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.BatchGetMessagesRequest, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.BatchGetMessagesResponse>;
     private __batchGet;
+    /**
+     * Apply one label change to up to 50 messages in a single request. The
+     * same add_labels and remove_labels apply to every message id, and at
+     * least one of them must be provided. The update is atomic: either all
+     * resolved messages are updated or none are. Missing or restricted ids
+     * are silently excluded; compare `count` against `limit` to detect
+     * exclusions.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:messages batch-update --inbox-id <inbox_id> --message-id <id1> --message-id <id2> --add-label read --remove-label unread
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.BatchUpdateMessagesRequest} request
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.messages.batchUpdate("inbox_id", {
+     *         messageIds: ["message_ids", "message_ids"]
+     *     })
+     */
+    batchUpdate(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.BatchUpdateMessagesRequest, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.BatchUpdateMessagesResponse>;
+    private __batchUpdate;
     /**
      * **CLI:**
      * ```bash

package/dist/cjs/api/resources/inboxes/resources/messages/client/Client.js

@@ -395,6 +395,89 @@ class MessagesClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v0/inboxes/{inbox_id}/messages/batch-get");
         });
     }
+    /**
+     * Apply one label change to up to 50 messages in a single request. The
+     * same add_labels and remove_labels apply to every message id, and at
+     * least one of them must be provided. The update is atomic: either all
+     * resolved messages are updated or none are. Missing or restricted ids
+     * are silently excluded; compare `count` against `limit` to detect
+     * exclusions.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:messages batch-update --inbox-id <inbox_id> --message-id <id1> --message-id <id2> --add-label read --remove-label unread
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.BatchUpdateMessagesRequest} request
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.messages.batchUpdate("inbox_id", {
+     *         messageIds: ["message_ids", "message_ids"]
+     *     })
+     */
+    batchUpdate(inbox_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__batchUpdate(inbox_id, request, requestOptions));
+    }
+    __batchUpdate(inbox_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 = (0, headers_js_1.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 }))}/messages/batch-update`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.BatchUpdateMessagesRequest.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: serializers.BatchUpdateMessagesResponse.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 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 (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v0/inboxes/{inbox_id}/messages/batch-update");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

package/dist/cjs/api/resources/messages/types/BatchUpdateMessagesMessageIds.d.ts

@@ -0,0 +1,8 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * IDs of messages to update. Maximum 50 ids per request. Duplicates are
+ * rejected with a validation error. IDs not found in the inbox (including
+ * cross-inbox or permission-restricted) are silently excluded from the
+ * update; callers detect exclusions by comparing `count` against `limit`.
+ */
+export type BatchUpdateMessagesMessageIds = AgentMail.MessageId[];

package/dist/cjs/api/resources/messages/types/BatchUpdateMessagesMessageIds.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/messages/types/BatchUpdateMessagesRequest.d.ts

@@ -0,0 +1,8 @@
+import type * as AgentMail from "../../../index.js";
+export interface BatchUpdateMessagesRequest {
+    messageIds: AgentMail.BatchUpdateMessagesMessageIds;
+    /** Label or labels to add to every message. */
+    addLabels?: AgentMail.UpdateMessageLabels;
+    /** Label or labels to remove from every message. */
+    removeLabels?: AgentMail.UpdateMessageLabels;
+}

package/dist/cjs/api/resources/messages/types/BatchUpdateMessagesRequest.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/messages/types/BatchUpdateMessagesResponse.d.ts

@@ -0,0 +1,11 @@
+import type * as AgentMail from "../../../index.js";
+export interface BatchUpdateMessagesResponse {
+    limit: AgentMail.Limit;
+    count: AgentMail.Count;
+    /**
+     * Updated messages with their new labels. Order matches `message_ids`
+     * in the request. Excluded ids are omitted, so `count` may be less than
+     * `limit`.
+     */
+    updates: AgentMail.UpdateMessageResponse[];
+}

package/dist/cjs/api/resources/messages/types/BatchUpdateMessagesResponse.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/messages/types/index.d.ts

@@ -2,6 +2,9 @@ export * from "./Addresses.js";
 export * from "./BatchGetMessagesMessageIds.js";
 export * from "./BatchGetMessagesRequest.js";
 export * from "./BatchGetMessagesResponse.js";
+export * from "./BatchUpdateMessagesMessageIds.js";
+export * from "./BatchUpdateMessagesRequest.js";
+export * from "./BatchUpdateMessagesResponse.js";
 export * from "./ListMessagesResponse.js";
 export * from "./Message.js";
 export * from "./MessageAttachments.js";

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

@@ -18,6 +18,9 @@ __exportStar(require("./Addresses.js"), exports);
 __exportStar(require("./BatchGetMessagesMessageIds.js"), exports);
 __exportStar(require("./BatchGetMessagesRequest.js"), exports);
 __exportStar(require("./BatchGetMessagesResponse.js"), exports);
+__exportStar(require("./BatchUpdateMessagesMessageIds.js"), exports);
+__exportStar(require("./BatchUpdateMessagesRequest.js"), exports);
+__exportStar(require("./BatchUpdateMessagesResponse.js"), exports);
 __exportStar(require("./ListMessagesResponse.js"), exports);
 __exportStar(require("./Message.js"), exports);
 __exportStar(require("./MessageAttachments.js"), exports);

package/dist/cjs/serialization/resources/messages/types/BatchUpdateMessagesMessageIds.d.ts

@@ -0,0 +1,8 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+import { MessageId } from "./MessageId.js";
+export declare const BatchUpdateMessagesMessageIds: core.serialization.Schema<serializers.BatchUpdateMessagesMessageIds.Raw, AgentMail.BatchUpdateMessagesMessageIds>;
+export declare namespace BatchUpdateMessagesMessageIds {
+    type Raw = MessageId.Raw[];
+}

package/dist/cjs/serialization/resources/messages/types/BatchUpdateMessagesMessageIds.js

@@ -0,0 +1,40 @@
+"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.BatchUpdateMessagesMessageIds = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+const MessageId_js_1 = require("./MessageId.js");
+exports.BatchUpdateMessagesMessageIds = core.serialization.list(MessageId_js_1.MessageId);

package/dist/cjs/serialization/resources/messages/types/BatchUpdateMessagesRequest.d.ts

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+import { BatchUpdateMessagesMessageIds } from "./BatchUpdateMessagesMessageIds.js";
+import { UpdateMessageLabels } from "./UpdateMessageLabels.js";
+export declare const BatchUpdateMessagesRequest: core.serialization.ObjectSchema<serializers.BatchUpdateMessagesRequest.Raw, AgentMail.BatchUpdateMessagesRequest>;
+export declare namespace BatchUpdateMessagesRequest {
+    interface Raw {
+        message_ids: BatchUpdateMessagesMessageIds.Raw;
+        add_labels?: UpdateMessageLabels.Raw | null;
+        remove_labels?: UpdateMessageLabels.Raw | null;
+    }
+}

package/dist/cjs/serialization/resources/messages/types/BatchUpdateMessagesRequest.js

@@ -0,0 +1,45 @@
+"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.BatchUpdateMessagesRequest = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+const BatchUpdateMessagesMessageIds_js_1 = require("./BatchUpdateMessagesMessageIds.js");
+const UpdateMessageLabels_js_1 = require("./UpdateMessageLabels.js");
+exports.BatchUpdateMessagesRequest = core.serialization.object({
+    messageIds: core.serialization.property("message_ids", BatchUpdateMessagesMessageIds_js_1.BatchUpdateMessagesMessageIds),
+    addLabels: core.serialization.property("add_labels", UpdateMessageLabels_js_1.UpdateMessageLabels.optional()),
+    removeLabels: core.serialization.property("remove_labels", UpdateMessageLabels_js_1.UpdateMessageLabels.optional()),
+});

package/dist/cjs/serialization/resources/messages/types/BatchUpdateMessagesResponse.d.ts

@@ -0,0 +1,14 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+import { Count } from "../../../types/Count.js";
+import { Limit } from "../../../types/Limit.js";
+import { UpdateMessageResponse } from "./UpdateMessageResponse.js";
+export declare const BatchUpdateMessagesResponse: core.serialization.ObjectSchema<serializers.BatchUpdateMessagesResponse.Raw, AgentMail.BatchUpdateMessagesResponse>;
+export declare namespace BatchUpdateMessagesResponse {
+    interface Raw {
+        limit: Limit.Raw;
+        count: Count.Raw;
+        updates: UpdateMessageResponse.Raw[];
+    }
+}

package/dist/cjs/serialization/resources/messages/types/BatchUpdateMessagesResponse.js

@@ -0,0 +1,46 @@
+"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.BatchUpdateMessagesResponse = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+const Count_js_1 = require("../../../types/Count.js");
+const Limit_js_1 = require("../../../types/Limit.js");
+const UpdateMessageResponse_js_1 = require("./UpdateMessageResponse.js");
+exports.BatchUpdateMessagesResponse = core.serialization.object({
+    limit: Limit_js_1.Limit,
+    count: Count_js_1.Count,
+    updates: core.serialization.list(UpdateMessageResponse_js_1.UpdateMessageResponse),
+});

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

@@ -2,6 +2,9 @@ export * from "./Addresses.js";
 export * from "./BatchGetMessagesMessageIds.js";
 export * from "./BatchGetMessagesRequest.js";
 export * from "./BatchGetMessagesResponse.js";
+export * from "./BatchUpdateMessagesMessageIds.js";
+export * from "./BatchUpdateMessagesRequest.js";
+export * from "./BatchUpdateMessagesResponse.js";
 export * from "./ListMessagesResponse.js";
 export * from "./Message.js";
 export * from "./MessageAttachments.js";

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

@@ -18,6 +18,9 @@ __exportStar(require("./Addresses.js"), exports);
 __exportStar(require("./BatchGetMessagesMessageIds.js"), exports);
 __exportStar(require("./BatchGetMessagesRequest.js"), exports);
 __exportStar(require("./BatchGetMessagesResponse.js"), exports);
+__exportStar(require("./BatchUpdateMessagesMessageIds.js"), exports);
+__exportStar(require("./BatchUpdateMessagesRequest.js"), exports);
+__exportStar(require("./BatchUpdateMessagesResponse.js"), exports);
 __exportStar(require("./ListMessagesResponse.js"), exports);
 __exportStar(require("./Message.js"), exports);
 __exportStar(require("./MessageAttachments.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.10";
+export declare const SDK_VERSION = "0.5.11";

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.10";
+exports.SDK_VERSION = "0.5.11";

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.10",
-        "User-Agent": "agentmail/0.5.10",
+        "X-Fern-SDK-Version": "0.5.11",
+        "User-Agent": "agentmail/0.5.11",
         "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/inboxes/resources/messages/client/Client.d.mts

@@ -93,6 +93,32 @@ export declare class MessagesClient {
      */
     batchGet(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.BatchGetMessagesRequest, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.BatchGetMessagesResponse>;
     private __batchGet;
+    /**
+     * Apply one label change to up to 50 messages in a single request. The
+     * same add_labels and remove_labels apply to every message id, and at
+     * least one of them must be provided. The update is atomic: either all
+     * resolved messages are updated or none are. Missing or restricted ids
+     * are silently excluded; compare `count` against `limit` to detect
+     * exclusions.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:messages batch-update --inbox-id <inbox_id> --message-id <id1> --message-id <id2> --add-label read --remove-label unread
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.BatchUpdateMessagesRequest} request
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.messages.batchUpdate("inbox_id", {
+     *         messageIds: ["message_ids", "message_ids"]
+     *     })
+     */
+    batchUpdate(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.BatchUpdateMessagesRequest, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.BatchUpdateMessagesResponse>;
+    private __batchUpdate;
     /**
      * **CLI:**
      * ```bash

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

@@ -359,6 +359,89 @@ export class MessagesClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v0/inboxes/{inbox_id}/messages/batch-get");
         });
     }
+    /**
+     * Apply one label change to up to 50 messages in a single request. The
+     * same add_labels and remove_labels apply to every message id, and at
+     * least one of them must be provided. The update is atomic: either all
+     * resolved messages are updated or none are. Missing or restricted ids
+     * are silently excluded; compare `count` against `limit` to detect
+     * exclusions.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:messages batch-update --inbox-id <inbox_id> --message-id <id1> --message-id <id2> --add-label read --remove-label unread
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.BatchUpdateMessagesRequest} request
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.messages.batchUpdate("inbox_id", {
+     *         messageIds: ["message_ids", "message_ids"]
+     *     })
+     */
+    batchUpdate(inbox_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__batchUpdate(inbox_id, request, requestOptions));
+    }
+    __batchUpdate(inbox_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 }))}/messages/batch-update`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.BatchUpdateMessagesRequest.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: serializers.BatchUpdateMessagesResponse.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 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, "POST", "/v0/inboxes/{inbox_id}/messages/batch-update");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

package/dist/esm/api/resources/messages/types/BatchUpdateMessagesMessageIds.d.mts

@@ -0,0 +1,8 @@
+import type * as AgentMail from "../../../index.mjs";
+/**
+ * IDs of messages to update. Maximum 50 ids per request. Duplicates are
+ * rejected with a validation error. IDs not found in the inbox (including
+ * cross-inbox or permission-restricted) are silently excluded from the
+ * update; callers detect exclusions by comparing `count` against `limit`.
+ */
+export type BatchUpdateMessagesMessageIds = AgentMail.MessageId[];

package/dist/esm/api/resources/messages/types/BatchUpdateMessagesMessageIds.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/messages/types/BatchUpdateMessagesRequest.d.mts

@@ -0,0 +1,8 @@
+import type * as AgentMail from "../../../index.mjs";
+export interface BatchUpdateMessagesRequest {
+    messageIds: AgentMail.BatchUpdateMessagesMessageIds;
+    /** Label or labels to add to every message. */
+    addLabels?: AgentMail.UpdateMessageLabels;
+    /** Label or labels to remove from every message. */
+    removeLabels?: AgentMail.UpdateMessageLabels;
+}

package/dist/esm/api/resources/messages/types/BatchUpdateMessagesRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/messages/types/BatchUpdateMessagesResponse.d.mts

@@ -0,0 +1,11 @@
+import type * as AgentMail from "../../../index.mjs";
+export interface BatchUpdateMessagesResponse {
+    limit: AgentMail.Limit;
+    count: AgentMail.Count;
+    /**
+     * Updated messages with their new labels. Order matches `message_ids`
+     * in the request. Excluded ids are omitted, so `count` may be less than
+     * `limit`.
+     */
+    updates: AgentMail.UpdateMessageResponse[];
+}

package/dist/esm/api/resources/messages/types/BatchUpdateMessagesResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/messages/types/index.d.mts

@@ -2,6 +2,9 @@ export * from "./Addresses.mjs";
 export * from "./BatchGetMessagesMessageIds.mjs";
 export * from "./BatchGetMessagesRequest.mjs";
 export * from "./BatchGetMessagesResponse.mjs";
+export * from "./BatchUpdateMessagesMessageIds.mjs";
+export * from "./BatchUpdateMessagesRequest.mjs";
+export * from "./BatchUpdateMessagesResponse.mjs";
 export * from "./ListMessagesResponse.mjs";
 export * from "./Message.mjs";
 export * from "./MessageAttachments.mjs";

package/dist/esm/api/resources/messages/types/index.mjs

@@ -2,6 +2,9 @@ export * from "./Addresses.mjs";
 export * from "./BatchGetMessagesMessageIds.mjs";
 export * from "./BatchGetMessagesRequest.mjs";
 export * from "./BatchGetMessagesResponse.mjs";
+export * from "./BatchUpdateMessagesMessageIds.mjs";
+export * from "./BatchUpdateMessagesRequest.mjs";
+export * from "./BatchUpdateMessagesResponse.mjs";
 export * from "./ListMessagesResponse.mjs";
 export * from "./Message.mjs";
 export * from "./MessageAttachments.mjs";

package/dist/esm/serialization/resources/messages/types/BatchUpdateMessagesMessageIds.d.mts

@@ -0,0 +1,8 @@
+import type * as AgentMail from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+import { MessageId } from "./MessageId.mjs";
+export declare const BatchUpdateMessagesMessageIds: core.serialization.Schema<serializers.BatchUpdateMessagesMessageIds.Raw, AgentMail.BatchUpdateMessagesMessageIds>;
+export declare namespace BatchUpdateMessagesMessageIds {
+    type Raw = MessageId.Raw[];
+}

package/dist/esm/serialization/resources/messages/types/BatchUpdateMessagesMessageIds.mjs

@@ -0,0 +1,4 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+import { MessageId } from "./MessageId.mjs";
+export const BatchUpdateMessagesMessageIds = core.serialization.list(MessageId);