agentmail 0.4.15 → 0.4.17

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

@@ -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/esm/api/resources/agent/client/Client.mjs

@@ -21,12 +21,19 @@ export class AgentClient {
         this._options = 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.
      *
@@ -103,6 +110,11 @@ export 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/esm/api/resources/apiKeys/client/Client.d.mts

@@ -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/esm/api/resources/apiKeys/client/Client.mjs

@@ -21,6 +21,11 @@ export class ApiKeysClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail api-keys list
+     * ```
+     *
      * @param {AgentMail.ListApiKeysRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -76,15 +81,18 @@ export 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));
@@ -146,6 +154,11 @@ export 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/esm/api/resources/apiKeys/types/CreateApiKeyRequest.d.mts

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

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

@@ -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/esm/api/resources/domains/client/Client.mjs

@@ -21,6 +21,11 @@ export class DomainsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains list
+     * ```
+     *
      * @param {AgentMail.ListDomainsRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -76,6 +81,11 @@ export class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains retrieve --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -138,6 +148,11 @@ export class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains get-zone-file --domain-id <domain_id>
+     * ```
+     *
      * @throws {@link AgentMail.NotFoundError}
      */
     getZoneFile(domain_id, requestOptions) {
@@ -186,6 +201,11 @@ export class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains create --domain example.com
+     * ```
+     *
      * @param {AgentMail.CreateDomainRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -257,6 +277,11 @@ export 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.
@@ -326,6 +351,11 @@ export class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains delete --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -379,6 +409,11 @@ export 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/esm/api/resources/domains/types/DomainItem.d.mts

@@ -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/esm/api/resources/drafts/client/Client.d.mts

@@ -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/esm/api/resources/drafts/client/Client.mjs

@@ -22,6 +22,11 @@ export class DraftsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail drafts list
+     * ```
+     *
      * @param {AgentMail.ListDraftsRequest} request
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -102,6 +107,11 @@ export class DraftsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail drafts retrieve --draft-id <draft_id>
+     * ```
+     *
      * @param {AgentMail.DraftId} draft_id
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -164,6 +174,11 @@ export 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/esm/api/resources/inboxes/client/Client.d.mts

@@ -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/esm/api/resources/inboxes/client/Client.mjs

@@ -51,6 +51,11 @@ export class InboxesClient {
         return ((_a = this._apiKeys) !== null && _a !== void 0 ? _a : (this._apiKeys = new ApiKeysClient(this._options)));
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes list
+     * ```
+     *
      * @param {AgentMail.inboxes.ListInboxesRequest} request
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -106,6 +111,11 @@ export class InboxesClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes retrieve --inbox-id <inbox_id>
+     * ```
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -168,6 +178,11 @@ export 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.
      *
@@ -236,6 +251,11 @@ export 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.
@@ -307,6 +327,11 @@ export 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/esm/api/resources/inboxes/resources/apiKeys/client/Client.d.mts

@@ -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/esm/api/resources/inboxes/resources/apiKeys/client/Client.mjs

@@ -21,6 +21,11 @@ export class ApiKeysClient {
         this._options = 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.
@@ -89,6 +94,11 @@ export 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.
@@ -97,9 +107,7 @@ export 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));
@@ -169,6 +177,11 @@ export 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.