agentmail 0.5.24 → 0.5.25

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

@@ -53,49 +53,44 @@ const errors = __importStar(require("../../../../errors/index.js"));
 const serializers = __importStar(require("../../../../serialization/index.js"));
 const AgentMail = __importStar(require("../../../index.js"));
 const Client_js_1 = require("../resources/apiKeys/client/Client.js");
-const Client_js_2 = require("../resources/browserCredentials/client/Client.js");
-const Client_js_3 = require("../resources/drafts/client/Client.js");
-const Client_js_4 = require("../resources/events/client/Client.js");
-const Client_js_5 = require("../resources/lists/client/Client.js");
-const Client_js_6 = require("../resources/messages/client/Client.js");
-const Client_js_7 = require("../resources/metrics/client/Client.js");
-const Client_js_8 = require("../resources/threads/client/Client.js");
-const Client_js_9 = require("../resources/webhooks/client/Client.js");
+const Client_js_2 = require("../resources/drafts/client/Client.js");
+const Client_js_3 = require("../resources/events/client/Client.js");
+const Client_js_4 = require("../resources/lists/client/Client.js");
+const Client_js_5 = require("../resources/messages/client/Client.js");
+const Client_js_6 = require("../resources/metrics/client/Client.js");
+const Client_js_7 = require("../resources/threads/client/Client.js");
+const Client_js_8 = require("../resources/webhooks/client/Client.js");
 class InboxesClient {
     constructor(options = {}) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     get threads() {
         var _a;
-        return ((_a = this._threads) !== null && _a !== void 0 ? _a : (this._threads = new Client_js_8.ThreadsClient(this._options)));
+        return ((_a = this._threads) !== null && _a !== void 0 ? _a : (this._threads = new Client_js_7.ThreadsClient(this._options)));
     }
     get messages() {
         var _a;
-        return ((_a = this._messages) !== null && _a !== void 0 ? _a : (this._messages = new Client_js_6.MessagesClient(this._options)));
+        return ((_a = this._messages) !== null && _a !== void 0 ? _a : (this._messages = new Client_js_5.MessagesClient(this._options)));
     }
     get drafts() {
         var _a;
-        return ((_a = this._drafts) !== null && _a !== void 0 ? _a : (this._drafts = new Client_js_3.DraftsClient(this._options)));
-    }
-    get browserCredentials() {
-        var _a;
-        return ((_a = this._browserCredentials) !== null && _a !== void 0 ? _a : (this._browserCredentials = new Client_js_2.BrowserCredentialsClient(this._options)));
+        return ((_a = this._drafts) !== null && _a !== void 0 ? _a : (this._drafts = new Client_js_2.DraftsClient(this._options)));
     }
     get webhooks() {
         var _a;
-        return ((_a = this._webhooks) !== null && _a !== void 0 ? _a : (this._webhooks = new Client_js_9.WebhooksClient(this._options)));
+        return ((_a = this._webhooks) !== null && _a !== void 0 ? _a : (this._webhooks = new Client_js_8.WebhooksClient(this._options)));
     }
     get lists() {
         var _a;
-        return ((_a = this._lists) !== null && _a !== void 0 ? _a : (this._lists = new Client_js_5.ListsClient(this._options)));
+        return ((_a = this._lists) !== null && _a !== void 0 ? _a : (this._lists = new Client_js_4.ListsClient(this._options)));
     }
     get metrics() {
         var _a;
-        return ((_a = this._metrics) !== null && _a !== void 0 ? _a : (this._metrics = new Client_js_7.MetricsClient(this._options)));
+        return ((_a = this._metrics) !== null && _a !== void 0 ? _a : (this._metrics = new Client_js_6.MetricsClient(this._options)));
     }
     get events() {
         var _a;
-        return ((_a = this._events) !== null && _a !== void 0 ? _a : (this._events = new Client_js_4.EventsClient(this._options)));
+        return ((_a = this._events) !== null && _a !== void 0 ? _a : (this._events = new Client_js_3.EventsClient(this._options)));
     }
     get apiKeys() {
         var _a;
@@ -528,5 +523,89 @@ class InboxesClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/v0/inboxes/{inbox_id}");
         });
     }
+    /**
+     * Authorizes the AgentID sign-in a client is already waiting in, for the
+     * inbox in the path, and returns the pending public key it will activate. A
+     * repeat for the same token, inbox, and bearer returns the same key.
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.inboxes.AuthorizeInboxRequest} request
+     * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.authorize("inbox_id", {
+     *         authToken: "blackcurrant.........."
+     *     })
+     */
+    authorize(inbox_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__authorize(inbox_id, request, requestOptions));
+    }
+    __authorize(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 }))}/authorize`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.inboxes.AuthorizeInboxRequest.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.PublicKeyCredential.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);
+                    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 (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v0/inboxes/{inbox_id}/authorize");
+        });
+    }
 }
 exports.InboxesClient = InboxesClient;

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

@@ -43,8 +43,27 @@ export declare class ApiKeysClient {
      * @example
      *     await client.inboxes.apiKeys.create("inbox_id", {})
      */
-    create(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.CreateApiKeyRequest, requestOptions?: ApiKeysClient.RequestOptions): core.HttpResponsePromise<AgentMail.CreateApiKeyResponse>;
+    create(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.CreateApiKeyRequest, requestOptions?: ApiKeysClient.RequestOptions): core.HttpResponsePromise<AgentMail.CreateApiKeyResult>;
     private __create;
+    /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes api-keys update --inbox-id <inbox_id> --api-key-id <api_key_id> --name "Renamed"
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.ApiKeyId} api_key_id
+     * @param {AgentMail.UpdateApiKeyRequest} request
+     * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.apiKeys.update("inbox_id", "api_key_id", {})
+     */
+    update(inbox_id: AgentMail.inboxes.InboxId, api_key_id: AgentMail.ApiKeyId, request: AgentMail.UpdateApiKeyRequest, requestOptions?: ApiKeysClient.RequestOptions): core.HttpResponsePromise<AgentMail.ApiKey>;
+    private __update;
     /**
      * **CLI:**
      * ```bash

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

@@ -173,7 +173,7 @@ class ApiKeysClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.CreateApiKeyResponse.parseOrThrow(_response.body, {
+                    data: serializers.CreateApiKeyResult.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -212,6 +212,90 @@ class ApiKeysClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v0/inboxes/{inbox_id}/api-keys");
         });
     }
+    /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes api-keys update --inbox-id <inbox_id> --api-key-id <api_key_id> --name "Renamed"
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.ApiKeyId} api_key_id
+     * @param {AgentMail.UpdateApiKeyRequest} request
+     * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.apiKeys.update("inbox_id", "api_key_id", {})
+     */
+    update(inbox_id, api_key_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__update(inbox_id, api_key_id, request, requestOptions));
+    }
+    __update(inbox_id, api_key_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 }))}/api-keys/${core.url.encodePathParam(serializers.ApiKeyId.jsonOrThrow(api_key_id, { omitUndefined: true }))}`),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.UpdateApiKeyRequest.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.ApiKey.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);
+                    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 (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "PATCH", "/v0/inboxes/{inbox_id}/api-keys/{api_key_id}");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

package/dist/cjs/api/resources/inboxes/resources/index.d.ts

@@ -1,6 +1,5 @@
 export * from "./apiKeys/client/requests/index.js";
 export * as apiKeys from "./apiKeys/index.js";
-export * as browserCredentials from "./browserCredentials/index.js";
 export * from "./drafts/client/requests/index.js";
 export * as drafts from "./drafts/index.js";
 export * from "./events/client/requests/index.js";

package/dist/cjs/api/resources/inboxes/resources/index.js

@@ -36,10 +36,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.webhooks = exports.threads = exports.metrics = exports.messages = exports.lists = exports.events = exports.drafts = exports.browserCredentials = exports.apiKeys = void 0;
+exports.webhooks = exports.threads = exports.metrics = exports.messages = exports.lists = exports.events = exports.drafts = exports.apiKeys = void 0;
 __exportStar(require("./apiKeys/client/requests/index.js"), exports);
 exports.apiKeys = __importStar(require("./apiKeys/index.js"));
-exports.browserCredentials = __importStar(require("./browserCredentials/index.js"));
 __exportStar(require("./drafts/client/requests/index.js"), exports);
 exports.drafts = __importStar(require("./drafts/index.js"));
 __exportStar(require("./events/client/requests/index.js"), exports);

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

@@ -0,0 +1,10 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * Authorize one pending AgentID sign-in for the inbox in the path. The
+ * inbox is selected by the trusted path parameter, never by an AgentID
+ * `login_hint`.
+ */
+export interface AuthorizeInboxRequest {
+    authToken: AgentMail.AuthToken;
+    acceptDisclosure?: AgentMail.AcceptDisclosure;
+}

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

@@ -1,3 +1,4 @@
+export * from "./AuthorizeInboxRequest.js";
 export * from "./ClientId.js";
 export * from "./CreateInboxRequest.js";
 export * from "./DisplayName.js";

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

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./AuthorizeInboxRequest.js"), exports);
 __exportStar(require("./ClientId.js"), exports);
 __exportStar(require("./CreateInboxRequest.js"), exports);
 __exportStar(require("./DisplayName.js"), exports);

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

@@ -45,6 +45,25 @@ export declare class ApiKeysClient {
      */
     create(pod_id: AgentMail.pods.PodId, request: AgentMail.CreateApiKeyRequest, requestOptions?: ApiKeysClient.RequestOptions): core.HttpResponsePromise<AgentMail.CreateApiKeyResponse>;
     private __create;
+    /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods api-keys update --pod-id <pod_id> --api-key-id <api_key_id> --name "Renamed"
+     * ```
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.ApiKeyId} api_key_id
+     * @param {AgentMail.UpdateApiKeyRequest} request
+     * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.pods.apiKeys.update("pod_id", "api_key_id", {})
+     */
+    update(pod_id: AgentMail.pods.PodId, api_key_id: AgentMail.ApiKeyId, request: AgentMail.UpdateApiKeyRequest, requestOptions?: ApiKeysClient.RequestOptions): core.HttpResponsePromise<AgentMail.ApiKey>;
+    private __update;
     /**
      * **CLI:**
      * ```bash

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

@@ -212,6 +212,90 @@ class ApiKeysClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v0/pods/{pod_id}/api-keys");
         });
     }
+    /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods api-keys update --pod-id <pod_id> --api-key-id <api_key_id> --name "Renamed"
+     * ```
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.ApiKeyId} api_key_id
+     * @param {AgentMail.UpdateApiKeyRequest} request
+     * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.pods.apiKeys.update("pod_id", "api_key_id", {})
+     */
+    update(pod_id, api_key_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__update(pod_id, api_key_id, request, requestOptions));
+    }
+    __update(pod_id, api_key_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/pods/${core.url.encodePathParam(serializers.pods.PodId.jsonOrThrow(pod_id, { omitUndefined: true }))}/api-keys/${core.url.encodePathParam(serializers.ApiKeyId.jsonOrThrow(api_key_id, { omitUndefined: true }))}`),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.UpdateApiKeyRequest.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.ApiKey.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);
+                    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 (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "PATCH", "/v0/pods/{pod_id}/api-keys/{api_key_id}");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

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

@@ -1,4 +1,4 @@
-import type { BaseClientOptions, BaseIdempotentRequestOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
 import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
 import * as core from "../../../../core/index.js";
 import * as AgentMail from "../../../index.js";
@@ -6,8 +6,6 @@ export declare namespace ProvidersClient {
     type Options = BaseClientOptions;
     interface RequestOptions extends BaseRequestOptions {
     }
-    interface IdempotentRequestOptions extends RequestOptions, BaseIdempotentRequestOptions {
-    }
 }
 export declare class ProvidersClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<ProvidersClient.Options>;
@@ -66,21 +64,21 @@ export declare class ProvidersClient {
     listAccounts(provider_id: AgentMail.ProviderId, request?: AgentMail.ListProviderAccountsRequest, requestOptions?: ProvidersClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListProviderAccountsResponse>;
     private __listAccounts;
     /**
-     * Starts signing an inbox in to a provider. Returns a `magic_url` valid
-     * for five minutes; open it in the browser that will hold the sign-in.
-     * Requires `api_key_create` and an `Idempotency-Key` header.
+     * Starts signing an inbox in to a provider. Returns a single-use `magic_url`,
+     * valid for five minutes, to open in the client that will hold the sign-in;
+     * the client enrolls as the inbox and continues to the provider. Poll
+     * [Get API Key](/api-reference/api-keys/get) with `api_key_id` for `status`.
      *
      * @param {AgentMail.ProviderId} provider_id
      * @param {AgentMail.ConnectProviderBody} request
-     * @param {ProvidersClient.IdempotentRequestOptions} requestOptions - Request-specific configuration.
+     * @param {ProvidersClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
      * @throws {@link AgentMail.NotFoundError}
-     * @throws {@link AgentMail.ConflictError}
      *
      * @example
      *     await client.providers.connect("d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", undefined)
      */
-    connect(provider_id: AgentMail.ProviderId, request?: AgentMail.ConnectProviderBody, requestOptions?: ProvidersClient.IdempotentRequestOptions): core.HttpResponsePromise<AgentMail.ConnectProviderAccepted>;
+    connect(provider_id: AgentMail.ProviderId, request?: AgentMail.ConnectProviderBody, requestOptions?: ProvidersClient.RequestOptions): core.HttpResponsePromise<AgentMail.ConnectAccepted>;
     private __connect;
 }

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

@@ -329,17 +329,17 @@ class ProvidersClient {
         });
     }
     /**
-     * Starts signing an inbox in to a provider. Returns a `magic_url` valid
-     * for five minutes; open it in the browser that will hold the sign-in.
-     * Requires `api_key_create` and an `Idempotency-Key` header.
+     * Starts signing an inbox in to a provider. Returns a single-use `magic_url`,
+     * valid for five minutes, to open in the client that will hold the sign-in;
+     * the client enrolls as the inbox and continues to the provider. Poll
+     * [Get API Key](/api-reference/api-keys/get) with `api_key_id` for `status`.
      *
      * @param {AgentMail.ProviderId} provider_id
      * @param {AgentMail.ConnectProviderBody} request
-     * @param {ProvidersClient.IdempotentRequestOptions} requestOptions - Request-specific configuration.
+     * @param {ProvidersClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
      * @throws {@link AgentMail.NotFoundError}
-     * @throws {@link AgentMail.ConflictError}
      *
      * @example
      *     await client.providers.connect("d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", undefined)
@@ -351,7 +351,7 @@ class ProvidersClient {
         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, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "Idempotency-Key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.idempotencyKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            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/providers/${core.url.encodePathParam(serializers.ProviderId.jsonOrThrow(provider_id, { omitUndefined: true }))}/connect`),
@@ -372,7 +372,7 @@ class ProvidersClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.ConnectProviderAccepted.parseOrThrow(_response.body, {
+                    data: serializers.ConnectAccepted.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -400,14 +400,6 @@ class ProvidersClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
-                    case 409:
-                        throw new AgentMail.ConflictError(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/providers/types/ConnectAccepted.d.ts

@@ -0,0 +1,9 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * The pending sign-in key the client will activate. Poll Get API Key with `api_key_id` for `status`.
+ */
+export interface ConnectAccepted {
+    apiKeyId: AgentMail.ApiKeyId;
+    magicUrl: AgentMail.MagicUrl;
+    expiresAt: AgentMail.ExpiresAt;
+}

package/dist/cjs/api/resources/providers/types/ConnectInboxId.d.ts

@@ -0,0 +1,5 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * Inbox to sign in as. Required unless the API key is scoped to an inbox.
+ */
+export type ConnectInboxId = AgentMail.inboxes.InboxId;

package/dist/cjs/api/resources/providers/types/ConnectProviderBody.d.ts

@@ -1,7 +1,5 @@
 import type * as AgentMail from "../../../index.js";
 export interface ConnectProviderBody {
-    /** Inbox to connect. Required unless the API key is scoped to an inbox. */
-    inboxId?: AgentMail.inboxes.InboxId;
-    /** Authorize the provider for this inbox, skipping the first-use disclosure page. */
-    authorize?: boolean;
+    inboxId?: AgentMail.ConnectInboxId;
+    acceptDisclosure?: AgentMail.AcceptDisclosure;
 }

package/dist/cjs/api/resources/providers/types/MagicUrl.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Single-use URL to open in the client that will hold the key.
+ */
+export type MagicUrl = string;

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

@@ -1,6 +1,8 @@
-export * from "./ConnectProviderAccepted.js";
+export * from "./ConnectAccepted.js";
+export * from "./ConnectInboxId.js";
 export * from "./ConnectProviderBody.js";
 export * from "./ListProviderAccountsResponse.js";
 export * from "./ListProvidersResponse.js";
+export * from "./MagicUrl.js";
 export * from "./Provider.js";
 export * from "./SearchProvidersResponse.js";

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

@@ -14,9 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./ConnectProviderAccepted.js"), exports);
+__exportStar(require("./ConnectAccepted.js"), exports);
+__exportStar(require("./ConnectInboxId.js"), exports);
 __exportStar(require("./ConnectProviderBody.js"), exports);
 __exportStar(require("./ListProviderAccountsResponse.js"), exports);
 __exportStar(require("./ListProvidersResponse.js"), exports);
+__exportStar(require("./MagicUrl.js"), exports);
 __exportStar(require("./Provider.js"), exports);
 __exportStar(require("./SearchProvidersResponse.js"), exports);

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

package/dist/cjs/serialization/resources/apiKeys/types/{OrganizationPublicKeyScope.js → AcceptDisclosure.js}

@@ -34,6 +34,6 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OrganizationPublicKeyScope = void 0;
+exports.AcceptDisclosure = void 0;
 const core = __importStar(require("../../../../core/index.js"));
-exports.OrganizationPublicKeyScope = core.serialization.object({});
+exports.AcceptDisclosure = core.serialization.boolean();