agentmail 0.5.9 → 0.5.10

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.9",
-        "User-Agent": "agentmail/0.5.9",
+        "X-Fern-SDK-Version": "0.5.10",
+        "User-Agent": "agentmail/0.5.10",
         "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/domains/client/Client.d.ts

@@ -63,8 +63,7 @@ export declare class DomainsClient {
      *
      * @example
      *     await client.domains.create({
-     *         domain: "domain",
-     *         feedbackEnabled: true
+     *         domain: "domain"
      *     })
      */
     create(request: AgentMail.CreateDomainRequest, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Domain>;

package/dist/cjs/api/resources/domains/client/Client.js

@@ -249,8 +249,7 @@ class DomainsClient {
      *
      * @example
      *     await client.domains.create({
-     *         domain: "domain",
-     *         feedbackEnabled: true
+     *         domain: "domain"
      *     })
      */
     create(request, requestOptions) {

package/dist/cjs/api/resources/domains/types/CreateDomainRequest.d.ts

@@ -1,5 +1,6 @@
 import type * as AgentMail from "../../../index.js";
 export interface CreateDomainRequest {
     domain: AgentMail.DomainName;
-    feedbackEnabled: AgentMail.FeedbackEnabled;
+    feedbackEnabled?: AgentMail.FeedbackEnabled;
+    subdomainsEnabled?: AgentMail.SubdomainsEnabled;
 }

package/dist/cjs/api/resources/domains/types/Domain.d.ts

@@ -5,7 +5,11 @@ export interface Domain {
     domain: AgentMail.DomainName;
     status: AgentMail.Status;
     feedbackEnabled: AgentMail.FeedbackEnabled;
-    /** A list of DNS records required to verify the domain. */
+    subdomainsEnabled: AgentMail.SubdomainsEnabled;
+    /**
+     * A list of DNS records required to verify the domain. Includes a
+     * wildcard MX record (`*.<domain>`) when `subdomains_enabled` is true.
+     */
     records: AgentMail.VerificationRecord[];
     clientId?: AgentMail.ClientId;
     /** Time at which the domain was last updated. */

package/dist/cjs/api/resources/domains/types/DomainItem.d.ts

@@ -4,6 +4,7 @@ export interface DomainItem {
     domainId: AgentMail.DomainId;
     domain: AgentMail.DomainName;
     feedbackEnabled: AgentMail.FeedbackEnabled;
+    subdomainsEnabled: AgentMail.SubdomainsEnabled;
     clientId?: AgentMail.ClientId;
     /** Time at which the domain was last updated. */
     updatedAt: Date;

package/dist/cjs/api/resources/domains/types/SubdomainsEnabled.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Allow inboxes on any subdomain of this domain. Adds a required wildcard MX
+ * record (`*.<domain>`) to `records`.
+ */
+export type SubdomainsEnabled = boolean;

package/dist/cjs/api/resources/domains/types/SubdomainsEnabled.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/domains/types/UpdateDomainRequest.d.ts

@@ -1,4 +1,11 @@
 import type * as AgentMail from "../../../index.js";
+/**
+ * Provide at least one of `feedback_enabled` or `subdomains_enabled`. Omitted
+ * fields are left unchanged; an empty body is rejected. Enabling
+ * `subdomains_enabled` on a verified domain returns it to `PENDING` until the
+ * newly-required wildcard MX record (`*.<domain>`) is published and verified.
+ */
 export interface UpdateDomainRequest {
     feedbackEnabled?: AgentMail.FeedbackEnabled;
+    subdomainsEnabled?: AgentMail.SubdomainsEnabled;
 }

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

@@ -9,6 +9,7 @@ export * from "./ListDomainsResponse.js";
 export * from "./RecordStatus.js";
 export * from "./RecordType.js";
 export * from "./Status.js";
+export * from "./SubdomainsEnabled.js";
 export * from "./UpdateDomainRequest.js";
 export * from "./VerificationRecord.js";
 export * from "./VerificationStatus.js";

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

@@ -25,6 +25,7 @@ __exportStar(require("./ListDomainsResponse.js"), exports);
 __exportStar(require("./RecordStatus.js"), exports);
 __exportStar(require("./RecordType.js"), exports);
 __exportStar(require("./Status.js"), exports);
+__exportStar(require("./SubdomainsEnabled.js"), exports);
 __exportStar(require("./UpdateDomainRequest.js"), exports);
 __exportStar(require("./VerificationRecord.js"), exports);
 __exportStar(require("./VerificationStatus.js"), exports);

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

@@ -71,6 +71,7 @@ export declare class InboxesClient {
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.UnprocessableError}
      *
      * @example
      *     await client.inboxes.create(undefined)

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

@@ -228,6 +228,7 @@ class InboxesClient {
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.UnprocessableError}
      *
      * @example
      *     await client.inboxes.create(undefined)
@@ -280,6 +281,14 @@ class InboxesClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 422:
+                        throw new AgentMail.UnprocessableError(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,

package/dist/cjs/api/resources/inboxes/types/CreateInboxRequest.d.ts

@@ -2,7 +2,11 @@ import type * as AgentMail from "../../../index.js";
 export interface CreateInboxRequest {
     /** Username of address. Randomly generated if not specified. */
     username?: string;
-    /** Domain of address. Must be verified domain. Defaults to `agentmail.to`. */
+    /**
+     * Domain of address. Must be a verified domain, or any subdomain of a
+     * verified domain that has subdomains enabled (e.g., `bot.example.com`).
+     * Defaults to `agentmail.to`.
+     */
     domain?: string;
     displayName?: AgentMail.inboxes.DisplayName;
     clientId?: AgentMail.inboxes.ClientId;

package/dist/cjs/api/resources/pods/resources/domains/client/Client.d.ts

@@ -68,8 +68,7 @@ export declare class DomainsClient {
      *
      * @example
      *     await client.pods.domains.create("pod_id", {
-     *         domain: "domain",
-     *         feedbackEnabled: true
+     *         domain: "domain"
      *     })
      */
     create(pod_id: AgentMail.pods.PodId, request: AgentMail.CreateDomainRequest, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Domain>;

package/dist/cjs/api/resources/pods/resources/domains/client/Client.js

@@ -265,8 +265,7 @@ class DomainsClient {
      *
      * @example
      *     await client.pods.domains.create("pod_id", {
-     *         domain: "domain",
-     *         feedbackEnabled: true
+     *         domain: "domain"
      *     })
      */
     create(pod_id, request, requestOptions) {

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

@@ -55,6 +55,7 @@ export declare class InboxesClient {
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.UnprocessableError}
      *
      * @example
      *     await client.pods.inboxes.create("pod_id", {})

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

@@ -209,6 +209,7 @@ class InboxesClient {
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.UnprocessableError}
      *
      * @example
      *     await client.pods.inboxes.create("pod_id", {})
@@ -261,6 +262,14 @@ class InboxesClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 422:
+                        throw new AgentMail.UnprocessableError(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,

package/dist/cjs/serialization/resources/domains/types/CreateDomainRequest.d.ts

@@ -3,10 +3,12 @@ import * as core from "../../../../core/index.js";
 import type * as serializers from "../../../index.js";
 import { DomainName } from "./DomainName.js";
 import { FeedbackEnabled } from "./FeedbackEnabled.js";
+import { SubdomainsEnabled } from "./SubdomainsEnabled.js";
 export declare const CreateDomainRequest: core.serialization.ObjectSchema<serializers.CreateDomainRequest.Raw, AgentMail.CreateDomainRequest>;
 export declare namespace CreateDomainRequest {
     interface Raw {
         domain: DomainName.Raw;
-        feedback_enabled: FeedbackEnabled.Raw;
+        feedback_enabled?: FeedbackEnabled.Raw | null;
+        subdomains_enabled?: SubdomainsEnabled.Raw | null;
     }
 }

package/dist/cjs/serialization/resources/domains/types/CreateDomainRequest.js

@@ -38,7 +38,9 @@ exports.CreateDomainRequest = void 0;
 const core = __importStar(require("../../../../core/index.js"));
 const DomainName_js_1 = require("./DomainName.js");
 const FeedbackEnabled_js_1 = require("./FeedbackEnabled.js");
+const SubdomainsEnabled_js_1 = require("./SubdomainsEnabled.js");
 exports.CreateDomainRequest = core.serialization.object({
     domain: DomainName_js_1.DomainName,
-    feedbackEnabled: core.serialization.property("feedback_enabled", FeedbackEnabled_js_1.FeedbackEnabled),
+    feedbackEnabled: core.serialization.property("feedback_enabled", FeedbackEnabled_js_1.FeedbackEnabled.optional()),
+    subdomainsEnabled: core.serialization.property("subdomains_enabled", SubdomainsEnabled_js_1.SubdomainsEnabled.optional()),
 });

package/dist/cjs/serialization/resources/domains/types/Domain.d.ts

@@ -7,6 +7,7 @@ import { DomainId } from "./DomainId.js";
 import { DomainName } from "./DomainName.js";
 import { FeedbackEnabled } from "./FeedbackEnabled.js";
 import { Status } from "./Status.js";
+import { SubdomainsEnabled } from "./SubdomainsEnabled.js";
 import { VerificationRecord } from "./VerificationRecord.js";
 export declare const Domain: core.serialization.ObjectSchema<serializers.Domain.Raw, AgentMail.Domain>;
 export declare namespace Domain {
@@ -16,6 +17,7 @@ export declare namespace Domain {
         domain: DomainName.Raw;
         status: Status.Raw;
         feedback_enabled: FeedbackEnabled.Raw;
+        subdomains_enabled: SubdomainsEnabled.Raw;
         records: VerificationRecord.Raw[];
         client_id?: ClientId.Raw | null;
         updated_at: string;

package/dist/cjs/serialization/resources/domains/types/Domain.js

@@ -42,6 +42,7 @@ const DomainId_js_1 = require("./DomainId.js");
 const DomainName_js_1 = require("./DomainName.js");
 const FeedbackEnabled_js_1 = require("./FeedbackEnabled.js");
 const Status_js_1 = require("./Status.js");
+const SubdomainsEnabled_js_1 = require("./SubdomainsEnabled.js");
 const VerificationRecord_js_1 = require("./VerificationRecord.js");
 exports.Domain = core.serialization.object({
     podId: core.serialization.property("pod_id", PodId_js_1.PodId.optional()),
@@ -49,6 +50,7 @@ exports.Domain = core.serialization.object({
     domain: DomainName_js_1.DomainName,
     status: Status_js_1.Status,
     feedbackEnabled: core.serialization.property("feedback_enabled", FeedbackEnabled_js_1.FeedbackEnabled),
+    subdomainsEnabled: core.serialization.property("subdomains_enabled", SubdomainsEnabled_js_1.SubdomainsEnabled),
     records: core.serialization.list(VerificationRecord_js_1.VerificationRecord),
     clientId: core.serialization.property("client_id", ClientId_js_1.ClientId.optional()),
     updatedAt: core.serialization.property("updated_at", core.serialization.date()),

package/dist/cjs/serialization/resources/domains/types/DomainItem.d.ts

@@ -6,6 +6,7 @@ import { ClientId } from "./ClientId.js";
 import { DomainId } from "./DomainId.js";
 import { DomainName } from "./DomainName.js";
 import { FeedbackEnabled } from "./FeedbackEnabled.js";
+import { SubdomainsEnabled } from "./SubdomainsEnabled.js";
 export declare const DomainItem: core.serialization.ObjectSchema<serializers.DomainItem.Raw, AgentMail.DomainItem>;
 export declare namespace DomainItem {
     interface Raw {
@@ -13,6 +14,7 @@ export declare namespace DomainItem {
         domain_id: DomainId.Raw;
         domain: DomainName.Raw;
         feedback_enabled: FeedbackEnabled.Raw;
+        subdomains_enabled: SubdomainsEnabled.Raw;
         client_id?: ClientId.Raw | null;
         updated_at: string;
         created_at: string;

package/dist/cjs/serialization/resources/domains/types/DomainItem.js

@@ -41,11 +41,13 @@ const ClientId_js_1 = require("./ClientId.js");
 const DomainId_js_1 = require("./DomainId.js");
 const DomainName_js_1 = require("./DomainName.js");
 const FeedbackEnabled_js_1 = require("./FeedbackEnabled.js");
+const SubdomainsEnabled_js_1 = require("./SubdomainsEnabled.js");
 exports.DomainItem = core.serialization.object({
     podId: core.serialization.property("pod_id", PodId_js_1.PodId.optional()),
     domainId: core.serialization.property("domain_id", DomainId_js_1.DomainId),
     domain: DomainName_js_1.DomainName,
     feedbackEnabled: core.serialization.property("feedback_enabled", FeedbackEnabled_js_1.FeedbackEnabled),
+    subdomainsEnabled: core.serialization.property("subdomains_enabled", SubdomainsEnabled_js_1.SubdomainsEnabled),
     clientId: core.serialization.property("client_id", ClientId_js_1.ClientId.optional()),
     updatedAt: core.serialization.property("updated_at", core.serialization.date()),
     createdAt: core.serialization.property("created_at", core.serialization.date()),

package/dist/cjs/serialization/resources/domains/types/SubdomainsEnabled.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 SubdomainsEnabled: core.serialization.Schema<serializers.SubdomainsEnabled.Raw, AgentMail.SubdomainsEnabled>;
+export declare namespace SubdomainsEnabled {
+    type Raw = boolean;
+}

package/dist/cjs/serialization/resources/domains/types/SubdomainsEnabled.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.SubdomainsEnabled = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+exports.SubdomainsEnabled = core.serialization.boolean();

package/dist/cjs/serialization/resources/domains/types/UpdateDomainRequest.d.ts

@@ -2,9 +2,11 @@ import type * as AgentMail from "../../../../api/index.js";
 import * as core from "../../../../core/index.js";
 import type * as serializers from "../../../index.js";
 import { FeedbackEnabled } from "./FeedbackEnabled.js";
+import { SubdomainsEnabled } from "./SubdomainsEnabled.js";
 export declare const UpdateDomainRequest: core.serialization.ObjectSchema<serializers.UpdateDomainRequest.Raw, AgentMail.UpdateDomainRequest>;
 export declare namespace UpdateDomainRequest {
     interface Raw {
         feedback_enabled?: FeedbackEnabled.Raw | null;
+        subdomains_enabled?: SubdomainsEnabled.Raw | null;
     }
 }

package/dist/cjs/serialization/resources/domains/types/UpdateDomainRequest.js

@@ -37,6 +37,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateDomainRequest = void 0;
 const core = __importStar(require("../../../../core/index.js"));
 const FeedbackEnabled_js_1 = require("./FeedbackEnabled.js");
+const SubdomainsEnabled_js_1 = require("./SubdomainsEnabled.js");
 exports.UpdateDomainRequest = core.serialization.object({
     feedbackEnabled: core.serialization.property("feedback_enabled", FeedbackEnabled_js_1.FeedbackEnabled.optional()),
+    subdomainsEnabled: core.serialization.property("subdomains_enabled", SubdomainsEnabled_js_1.SubdomainsEnabled.optional()),
 });

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

@@ -9,6 +9,7 @@ export * from "./ListDomainsResponse.js";
 export * from "./RecordStatus.js";
 export * from "./RecordType.js";
 export * from "./Status.js";
+export * from "./SubdomainsEnabled.js";
 export * from "./UpdateDomainRequest.js";
 export * from "./VerificationRecord.js";
 export * from "./VerificationStatus.js";

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

@@ -25,6 +25,7 @@ __exportStar(require("./ListDomainsResponse.js"), exports);
 __exportStar(require("./RecordStatus.js"), exports);
 __exportStar(require("./RecordType.js"), exports);
 __exportStar(require("./Status.js"), exports);
+__exportStar(require("./SubdomainsEnabled.js"), exports);
 __exportStar(require("./UpdateDomainRequest.js"), exports);
 __exportStar(require("./VerificationRecord.js"), exports);
 __exportStar(require("./VerificationStatus.js"), exports);

package/dist/cjs/version.d.ts

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

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.9";
+exports.SDK_VERSION = "0.5.10";

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.9",
-        "User-Agent": "agentmail/0.5.9",
+        "X-Fern-SDK-Version": "0.5.10",
+        "User-Agent": "agentmail/0.5.10",
         "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/domains/client/Client.d.mts

@@ -63,8 +63,7 @@ export declare class DomainsClient {
      *
      * @example
      *     await client.domains.create({
-     *         domain: "domain",
-     *         feedbackEnabled: true
+     *         domain: "domain"
      *     })
      */
     create(request: AgentMail.CreateDomainRequest, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Domain>;

package/dist/esm/api/resources/domains/client/Client.mjs

@@ -213,8 +213,7 @@ export class DomainsClient {
      *
      * @example
      *     await client.domains.create({
-     *         domain: "domain",
-     *         feedbackEnabled: true
+     *         domain: "domain"
      *     })
      */
     create(request, requestOptions) {

package/dist/esm/api/resources/domains/types/CreateDomainRequest.d.mts

@@ -1,5 +1,6 @@
 import type * as AgentMail from "../../../index.mjs";
 export interface CreateDomainRequest {
     domain: AgentMail.DomainName;
-    feedbackEnabled: AgentMail.FeedbackEnabled;
+    feedbackEnabled?: AgentMail.FeedbackEnabled;
+    subdomainsEnabled?: AgentMail.SubdomainsEnabled;
 }

package/dist/esm/api/resources/domains/types/Domain.d.mts

@@ -5,7 +5,11 @@ export interface Domain {
     domain: AgentMail.DomainName;
     status: AgentMail.Status;
     feedbackEnabled: AgentMail.FeedbackEnabled;
-    /** A list of DNS records required to verify the domain. */
+    subdomainsEnabled: AgentMail.SubdomainsEnabled;
+    /**
+     * A list of DNS records required to verify the domain. Includes a
+     * wildcard MX record (`*.<domain>`) when `subdomains_enabled` is true.
+     */
     records: AgentMail.VerificationRecord[];
     clientId?: AgentMail.ClientId;
     /** Time at which the domain was last updated. */

package/dist/esm/api/resources/domains/types/DomainItem.d.mts

@@ -4,6 +4,7 @@ export interface DomainItem {
     domainId: AgentMail.DomainId;
     domain: AgentMail.DomainName;
     feedbackEnabled: AgentMail.FeedbackEnabled;
+    subdomainsEnabled: AgentMail.SubdomainsEnabled;
     clientId?: AgentMail.ClientId;
     /** Time at which the domain was last updated. */
     updatedAt: Date;

package/dist/esm/api/resources/domains/types/SubdomainsEnabled.d.mts

@@ -0,0 +1,5 @@
+/**
+ * Allow inboxes on any subdomain of this domain. Adds a required wildcard MX
+ * record (`*.<domain>`) to `records`.
+ */
+export type SubdomainsEnabled = boolean;

package/dist/esm/api/resources/domains/types/SubdomainsEnabled.mjs

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

package/dist/esm/api/resources/domains/types/UpdateDomainRequest.d.mts

@@ -1,4 +1,11 @@
 import type * as AgentMail from "../../../index.mjs";
+/**
+ * Provide at least one of `feedback_enabled` or `subdomains_enabled`. Omitted
+ * fields are left unchanged; an empty body is rejected. Enabling
+ * `subdomains_enabled` on a verified domain returns it to `PENDING` until the
+ * newly-required wildcard MX record (`*.<domain>`) is published and verified.
+ */
 export interface UpdateDomainRequest {
     feedbackEnabled?: AgentMail.FeedbackEnabled;
+    subdomainsEnabled?: AgentMail.SubdomainsEnabled;
 }

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

@@ -9,6 +9,7 @@ export * from "./ListDomainsResponse.mjs";
 export * from "./RecordStatus.mjs";
 export * from "./RecordType.mjs";
 export * from "./Status.mjs";
+export * from "./SubdomainsEnabled.mjs";
 export * from "./UpdateDomainRequest.mjs";
 export * from "./VerificationRecord.mjs";
 export * from "./VerificationStatus.mjs";

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

@@ -9,6 +9,7 @@ export * from "./ListDomainsResponse.mjs";
 export * from "./RecordStatus.mjs";
 export * from "./RecordType.mjs";
 export * from "./Status.mjs";
+export * from "./SubdomainsEnabled.mjs";
 export * from "./UpdateDomainRequest.mjs";
 export * from "./VerificationRecord.mjs";
 export * from "./VerificationStatus.mjs";

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

@@ -71,6 +71,7 @@ export declare class InboxesClient {
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.UnprocessableError}
      *
      * @example
      *     await client.inboxes.create(undefined)

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

@@ -192,6 +192,7 @@ export class InboxesClient {
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.UnprocessableError}
      *
      * @example
      *     await client.inboxes.create(undefined)
@@ -244,6 +245,14 @@ export class InboxesClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 422:
+                        throw new AgentMail.UnprocessableError(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,

package/dist/esm/api/resources/inboxes/types/CreateInboxRequest.d.mts

@@ -2,7 +2,11 @@ import type * as AgentMail from "../../../index.mjs";
 export interface CreateInboxRequest {
     /** Username of address. Randomly generated if not specified. */
     username?: string;
-    /** Domain of address. Must be verified domain. Defaults to `agentmail.to`. */
+    /**
+     * Domain of address. Must be a verified domain, or any subdomain of a
+     * verified domain that has subdomains enabled (e.g., `bot.example.com`).
+     * Defaults to `agentmail.to`.
+     */
     domain?: string;
     displayName?: AgentMail.inboxes.DisplayName;
     clientId?: AgentMail.inboxes.ClientId;

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

@@ -68,8 +68,7 @@ export declare class DomainsClient {
      *
      * @example
      *     await client.pods.domains.create("pod_id", {
-     *         domain: "domain",
-     *         feedbackEnabled: true
+     *         domain: "domain"
      *     })
      */
     create(pod_id: AgentMail.pods.PodId, request: AgentMail.CreateDomainRequest, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Domain>;

package/dist/esm/api/resources/pods/resources/domains/client/Client.mjs

@@ -229,8 +229,7 @@ export class DomainsClient {
      *
      * @example
      *     await client.pods.domains.create("pod_id", {
-     *         domain: "domain",
-     *         feedbackEnabled: true
+     *         domain: "domain"
      *     })
      */
     create(pod_id, request, requestOptions) {

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

@@ -55,6 +55,7 @@ export declare class InboxesClient {
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.UnprocessableError}
      *
      * @example
      *     await client.pods.inboxes.create("pod_id", {})

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

@@ -173,6 +173,7 @@ export class InboxesClient {
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.UnprocessableError}
      *
      * @example
      *     await client.pods.inboxes.create("pod_id", {})
@@ -225,6 +226,14 @@ export class InboxesClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 422:
+                        throw new AgentMail.UnprocessableError(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,