agentmail 0.4.15 → 0.4.17

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.4.15",
-        "User-Agent": "agentmail/0.4.15",
+        "X-Fern-SDK-Version": "0.4.17",
+        "User-Agent": "agentmail/0.4.17",
         "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/agent/client/Client.d.ts

@@ -11,12 +11,19 @@ export declare class AgentClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<AgentClient.Options>;
     constructor(options?: AgentClient.Options);
     /**
-     * Create a new agent organization with an inbox and API key. A 6-digit OTP is sent to the human's email for verification.
+     * Create a new agent organization with an inbox and API key. This endpoint is for signing up for the first time. If you've already signed up, you're all set — just use your existing API key.
+     *
+     * A 6-digit OTP is sent to the human's email for verification.
      *
      * This endpoint is idempotent. Calling it again with the same `human_email` will rotate the API key and resend the OTP if expired.
      *
      * The returned API key has limited permissions until the organization is verified via the verify endpoint.
      *
+     * **CLI:**
+     * ```bash
+     * agentmail agent sign-up --human-email user@example.com --username my-agent
+     * ```
+     *
      * @param {AgentMail.AgentSignupRequest} request
      * @param {AgentClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -37,6 +44,11 @@ export declare class AgentClient {
      *
      * The OTP expires after 24 hours and allows a maximum of 10 attempts.
      *
+     * **CLI:**
+     * ```bash
+     * agentmail agent verify --otp-code 123456
+     * ```
+     *
      * @param {AgentMail.AgentVerifyRequest} request
      * @param {AgentClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -57,12 +57,19 @@ class AgentClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Create a new agent organization with an inbox and API key. A 6-digit OTP is sent to the human's email for verification.
+     * Create a new agent organization with an inbox and API key. This endpoint is for signing up for the first time. If you've already signed up, you're all set — just use your existing API key.
+     *
+     * A 6-digit OTP is sent to the human's email for verification.
      *
      * This endpoint is idempotent. Calling it again with the same `human_email` will rotate the API key and resend the OTP if expired.
      *
      * The returned API key has limited permissions until the organization is verified via the verify endpoint.
      *
+     * **CLI:**
+     * ```bash
+     * agentmail agent sign-up --human-email user@example.com --username my-agent
+     * ```
+     *
      * @param {AgentMail.AgentSignupRequest} request
      * @param {AgentClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -139,6 +146,11 @@ class AgentClient {
      *
      * The OTP expires after 24 hours and allows a maximum of 10 attempts.
      *
+     * **CLI:**
+     * ```bash
+     * agentmail agent verify --otp-code 123456
+     * ```
+     *
      * @param {AgentMail.AgentVerifyRequest} request
      * @param {AgentClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -11,6 +11,11 @@ export declare class ApiKeysClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<ApiKeysClient.Options>;
     constructor(options?: ApiKeysClient.Options);
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail api-keys list
+     * ```
+     *
      * @param {AgentMail.ListApiKeysRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -20,19 +25,27 @@ export declare class ApiKeysClient {
     list(request?: AgentMail.ListApiKeysRequest, requestOptions?: ApiKeysClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListApiKeysResponse>;
     private __list;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail api-keys create --name "My Key"
+     * ```
+     *
      * @param {AgentMail.CreateApiKeyRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.apiKeys.create({
-     *         name: "name"
-     *     })
+     *     await client.apiKeys.create({})
      */
     create(request: AgentMail.CreateApiKeyRequest, requestOptions?: ApiKeysClient.RequestOptions): core.HttpResponsePromise<AgentMail.CreateApiKeyResponse>;
     private __create;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail api-keys delete --api-key-id <api_key_id>
+     * ```
+     *
      * @param {AgentMail.ApiKeyId} api_key_id
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -57,6 +57,11 @@ class ApiKeysClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail api-keys list
+     * ```
+     *
      * @param {AgentMail.ListApiKeysRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -112,15 +117,18 @@ class ApiKeysClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail api-keys create --name "My Key"
+     * ```
+     *
      * @param {AgentMail.CreateApiKeyRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.apiKeys.create({
-     *         name: "name"
-     *     })
+     *     await client.apiKeys.create({})
      */
     create(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
@@ -182,6 +190,11 @@ class ApiKeysClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail api-keys delete --api-key-id <api_key_id>
+     * ```
+     *
      * @param {AgentMail.ApiKeyId} api_key_id
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/apiKeys/types/CreateApiKeyRequest.d.ts

@@ -1,5 +1,5 @@
 import type * as AgentMail from "../../../index.js";
 export interface CreateApiKeyRequest {
-    name: AgentMail.Name;
+    name?: AgentMail.Name;
     permissions?: AgentMail.ApiKeyPermissions;
 }

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

@@ -11,6 +11,11 @@ export declare class DomainsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<DomainsClient.Options>;
     constructor(options?: DomainsClient.Options);
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains list
+     * ```
+     *
      * @param {AgentMail.ListDomainsRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -20,6 +25,11 @@ export declare class DomainsClient {
     list(request?: AgentMail.ListDomainsRequest, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListDomainsResponse>;
     private __list;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains retrieve --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -31,11 +41,21 @@ export declare class DomainsClient {
     get(domain_id: AgentMail.DomainId, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Domain>;
     private __get;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains get-zone-file --domain-id <domain_id>
+     * ```
+     *
      * @throws {@link AgentMail.NotFoundError}
      */
     getZoneFile(domain_id: AgentMail.DomainId, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
     private __getZoneFile;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains create --domain example.com
+     * ```
+     *
      * @param {AgentMail.CreateDomainRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -50,6 +70,11 @@ export declare class DomainsClient {
     create(request: AgentMail.CreateDomainRequest, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Domain>;
     private __create;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains update --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {AgentMail.UpdateDomainRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -62,6 +87,11 @@ export declare class DomainsClient {
     update(domain_id: AgentMail.DomainId, request: AgentMail.UpdateDomainRequest, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Domain>;
     private __update;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains delete --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -73,6 +103,11 @@ export declare class DomainsClient {
     delete(domain_id: AgentMail.DomainId, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<void>;
     private __delete;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains verify --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -57,6 +57,11 @@ class DomainsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains list
+     * ```
+     *
      * @param {AgentMail.ListDomainsRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -112,6 +117,11 @@ class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains retrieve --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -174,6 +184,11 @@ class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains get-zone-file --domain-id <domain_id>
+     * ```
+     *
      * @throws {@link AgentMail.NotFoundError}
      */
     getZoneFile(domain_id, requestOptions) {
@@ -222,6 +237,11 @@ class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains create --domain example.com
+     * ```
+     *
      * @param {AgentMail.CreateDomainRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -293,6 +313,11 @@ class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains update --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {AgentMail.UpdateDomainRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -362,6 +387,11 @@ class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains delete --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -415,6 +445,11 @@ class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains verify --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -3,7 +3,6 @@ export interface DomainItem {
     podId?: AgentMail.pods.PodId;
     domainId: AgentMail.DomainId;
     domain: AgentMail.DomainName;
-    status: AgentMail.Status;
     feedbackEnabled: AgentMail.FeedbackEnabled;
     clientId?: AgentMail.ClientId;
     /** Time at which the domain was last updated. */

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

@@ -11,6 +11,11 @@ export declare class DraftsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<DraftsClient.Options>;
     constructor(options?: DraftsClient.Options);
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail drafts list
+     * ```
+     *
      * @param {AgentMail.ListDraftsRequest} request
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -22,6 +27,11 @@ export declare class DraftsClient {
     list(request?: AgentMail.ListDraftsRequest, requestOptions?: DraftsClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListDraftsResponse>;
     private __list;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail drafts retrieve --draft-id <draft_id>
+     * ```
+     *
      * @param {AgentMail.DraftId} draft_id
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -33,6 +43,11 @@ export declare class DraftsClient {
     get(draft_id: AgentMail.DraftId, requestOptions?: DraftsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Draft>;
     private __get;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail drafts get-attachment --draft-id <draft_id> --attachment-id <attachment_id>
+     * ```
+     *
      * @param {AgentMail.DraftId} draft_id
      * @param {AgentMail.AttachmentId} attachment_id
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -58,6 +58,11 @@ class DraftsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail drafts list
+     * ```
+     *
      * @param {AgentMail.ListDraftsRequest} request
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -138,6 +143,11 @@ class DraftsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail drafts retrieve --draft-id <draft_id>
+     * ```
+     *
      * @param {AgentMail.DraftId} draft_id
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -200,6 +210,11 @@ class DraftsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail drafts get-attachment --draft-id <draft_id> --attachment-id <attachment_id>
+     * ```
+     *
      * @param {AgentMail.DraftId} draft_id
      * @param {AgentMail.AttachmentId} attachment_id
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -29,6 +29,11 @@ export declare class InboxesClient {
     get metrics(): MetricsClient;
     get apiKeys(): ApiKeysClient;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes list
+     * ```
+     *
      * @param {AgentMail.inboxes.ListInboxesRequest} request
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -38,6 +43,11 @@ export declare class InboxesClient {
     list(request?: AgentMail.inboxes.ListInboxesRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.ListInboxesResponse>;
     private __list;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes retrieve --inbox-id <inbox_id>
+     * ```
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -49,6 +59,11 @@ export declare class InboxesClient {
     get(inbox_id: AgentMail.inboxes.InboxId, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.Inbox>;
     private __get;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes create --display-name "My Agent" --username myagent --domain agentmail.to
+     * ```
+     *
      * @param {AgentMail.inboxes.CreateInboxRequest} request
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -60,6 +75,11 @@ export declare class InboxesClient {
     create(request?: AgentMail.inboxes.CreateInboxRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.Inbox>;
     private __create;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes update --inbox-id <inbox_id> --display-name "Updated Name"
+     * ```
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {AgentMail.inboxes.UpdateInboxRequest} request
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -74,6 +94,11 @@ export declare class InboxesClient {
     update(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.inboxes.UpdateInboxRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.Inbox>;
     private __update;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes delete --inbox-id <inbox_id>
+     * ```
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -87,6 +87,11 @@ class InboxesClient {
         return ((_a = this._apiKeys) !== null && _a !== void 0 ? _a : (this._apiKeys = new Client_js_1.ApiKeysClient(this._options)));
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes list
+     * ```
+     *
      * @param {AgentMail.inboxes.ListInboxesRequest} request
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -142,6 +147,11 @@ class InboxesClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes retrieve --inbox-id <inbox_id>
+     * ```
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -204,6 +214,11 @@ class InboxesClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes create --display-name "My Agent" --username myagent --domain agentmail.to
+     * ```
+     *
      * @param {AgentMail.inboxes.CreateInboxRequest} request
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -272,6 +287,11 @@ class InboxesClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes update --inbox-id <inbox_id> --display-name "Updated Name"
+     * ```
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {AgentMail.inboxes.UpdateInboxRequest} request
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -343,6 +363,11 @@ class InboxesClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes delete --inbox-id <inbox_id>
+     * ```
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -11,6 +11,11 @@ export declare class ApiKeysClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<ApiKeysClient.Options>;
     constructor(options?: ApiKeysClient.Options);
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:api-keys list --inbox-id <inbox_id>
+     * ```
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {AgentMail.inboxes.ListApiKeysRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -23,6 +28,11 @@ export declare class ApiKeysClient {
     list(inbox_id: AgentMail.inboxes.InboxId, request?: AgentMail.inboxes.ListApiKeysRequest, requestOptions?: ApiKeysClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListApiKeysResponse>;
     private __list;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:api-keys create --inbox-id <inbox_id> --name "My Key"
+     * ```
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {AgentMail.CreateApiKeyRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -31,13 +41,16 @@ export declare class ApiKeysClient {
      * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.inboxes.apiKeys.create("inbox_id", {
-     *         name: "name"
-     *     })
+     *     await client.inboxes.apiKeys.create("inbox_id", {})
      */
     create(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.CreateApiKeyRequest, requestOptions?: ApiKeysClient.RequestOptions): core.HttpResponsePromise<AgentMail.CreateApiKeyResponse>;
     private __create;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:api-keys delete --inbox-id <inbox_id> --api-key-id <api_key_id>
+     * ```
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {AgentMail.ApiKeyId} api_key_id
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -57,6 +57,11 @@ class ApiKeysClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:api-keys list --inbox-id <inbox_id>
+     * ```
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {AgentMail.inboxes.ListApiKeysRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -125,6 +130,11 @@ class ApiKeysClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:api-keys create --inbox-id <inbox_id> --name "My Key"
+     * ```
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {AgentMail.CreateApiKeyRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -133,9 +143,7 @@ class ApiKeysClient {
      * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.inboxes.apiKeys.create("inbox_id", {
-     *         name: "name"
-     *     })
+     *     await client.inboxes.apiKeys.create("inbox_id", {})
      */
     create(inbox_id, request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__create(inbox_id, request, requestOptions));
@@ -205,6 +213,11 @@ class ApiKeysClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:api-keys delete --inbox-id <inbox_id> --api-key-id <api_key_id>
+     * ```
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {AgentMail.ApiKeyId} api_key_id
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.