agentmail 0.4.15 → 0.4.17

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

@@ -11,6 +11,11 @@ export declare class ListsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<ListsClient.Options>;
     constructor(options?: ListsClient.Options);
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail lists list --direction <direction> --type <type>
+     * ```
+     *
      * @param {AgentMail.Direction} direction
      * @param {AgentMail.ListType} type
      * @param {AgentMail.ListListEntriesRequest} request
@@ -22,6 +27,11 @@ export declare class ListsClient {
     list(direction: AgentMail.Direction, type: AgentMail.ListType, request?: AgentMail.ListListEntriesRequest, requestOptions?: ListsClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListListEntriesResponse>;
     private __list;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail lists retrieve --direction <direction> --type <type> --entry <entry>
+     * ```
+     *
      * @param {AgentMail.Direction} direction
      * @param {AgentMail.ListType} type
      * @param {string} entry - Email address or domain.
@@ -35,6 +45,11 @@ export declare class ListsClient {
     get(direction: AgentMail.Direction, type: AgentMail.ListType, entry: string, requestOptions?: ListsClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListEntry>;
     private __get;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail lists create --direction <direction> --type <type> --entry user@example.com
+     * ```
+     *
      * @param {AgentMail.Direction} direction
      * @param {AgentMail.ListType} type
      * @param {AgentMail.CreateListEntryRequest} request
@@ -50,6 +65,11 @@ export declare class ListsClient {
     create(direction: AgentMail.Direction, type: AgentMail.ListType, request: AgentMail.CreateListEntryRequest, requestOptions?: ListsClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListEntry>;
     private __create;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail lists delete --direction <direction> --type <type> --entry <entry>
+     * ```
+     *
      * @param {AgentMail.Direction} direction
      * @param {AgentMail.ListType} type
      * @param {string} entry - Email address or domain.

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

@@ -21,6 +21,11 @@ export class ListsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail lists list --direction <direction> --type <type>
+     * ```
+     *
      * @param {AgentMail.Direction} direction
      * @param {AgentMail.ListType} type
      * @param {AgentMail.ListListEntriesRequest} request
@@ -77,6 +82,11 @@ export class ListsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail lists retrieve --direction <direction> --type <type> --entry <entry>
+     * ```
+     *
      * @param {AgentMail.Direction} direction
      * @param {AgentMail.ListType} type
      * @param {string} entry - Email address or domain.
@@ -141,6 +151,11 @@ export class ListsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail lists create --direction <direction> --type <type> --entry user@example.com
+     * ```
+     *
      * @param {AgentMail.Direction} direction
      * @param {AgentMail.ListType} type
      * @param {AgentMail.CreateListEntryRequest} request
@@ -213,6 +228,11 @@ export class ListsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail lists delete --direction <direction> --type <type> --entry <entry>
+     * ```
+     *
      * @param {AgentMail.Direction} direction
      * @param {AgentMail.ListType} type
      * @param {string} entry - Email address or domain.

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

@@ -0,0 +1,4 @@
+/**
+ * Label or list of labels.
+ */
+export type UpdateMessageLabels = string | string[];

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

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

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

@@ -1,6 +1,7 @@
+import type * as AgentMail from "../../../index.mjs";
 export interface UpdateMessageRequest {
-    /** Labels to add to message. */
-    addLabels?: string[];
-    /** Labels to remove from message. */
-    removeLabels?: string[];
+    /** Label or labels to add to message. */
+    addLabels?: AgentMail.UpdateMessageLabels;
+    /** Label or labels to remove from message. */
+    removeLabels?: AgentMail.UpdateMessageLabels;
 }

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

@@ -33,5 +33,6 @@ export * from "./SendMessageReplyTo.mjs";
 export * from "./SendMessageRequest.mjs";
 export * from "./SendMessageResponse.mjs";
 export * from "./SendMessageTo.mjs";
+export * from "./UpdateMessageLabels.mjs";
 export * from "./UpdateMessageRequest.mjs";
 export * from "./UpdateMessageResponse.mjs";

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

@@ -33,5 +33,6 @@ export * from "./SendMessageReplyTo.mjs";
 export * from "./SendMessageRequest.mjs";
 export * from "./SendMessageResponse.mjs";
 export * from "./SendMessageTo.mjs";
+export * from "./UpdateMessageLabels.mjs";
 export * from "./UpdateMessageRequest.mjs";
 export * from "./UpdateMessageResponse.mjs";

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

@@ -11,6 +11,11 @@ export declare class MetricsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<MetricsClient.Options>;
     constructor(options?: MetricsClient.Options);
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail metrics list
+     * ```
+     *
      * @param {AgentMail.QueryMetricsRequest} request
      * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -22,6 +22,11 @@ export class MetricsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail metrics list
+     * ```
+     *
      * @param {AgentMail.QueryMetricsRequest} request
      * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -32,6 +32,11 @@ export declare class PodsClient {
     get metrics(): MetricsClient;
     get apiKeys(): ApiKeysClient;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods list
+     * ```
+     *
      * @param {AgentMail.pods.ListPodsRequest} request
      * @param {PodsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -41,6 +46,11 @@ export declare class PodsClient {
     list(request?: AgentMail.pods.ListPodsRequest, requestOptions?: PodsClient.RequestOptions): core.HttpResponsePromise<AgentMail.pods.ListPodsResponse>;
     private __list;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods retrieve --pod-id <pod_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {PodsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -52,6 +62,11 @@ export declare class PodsClient {
     get(pod_id: AgentMail.pods.PodId, requestOptions?: PodsClient.RequestOptions): core.HttpResponsePromise<AgentMail.pods.Pod>;
     private __get;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods create --client-id my-pod
+     * ```
+     *
      * @param {AgentMail.pods.CreatePodRequest} request
      * @param {PodsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -63,6 +78,11 @@ export declare class PodsClient {
     create(request: AgentMail.pods.CreatePodRequest, requestOptions?: PodsClient.RequestOptions): core.HttpResponsePromise<AgentMail.pods.Pod>;
     private __create;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods delete --pod-id <pod_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {PodsClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -56,6 +56,11 @@ export class PodsClient {
         return ((_a = this._apiKeys) !== null && _a !== void 0 ? _a : (this._apiKeys = new ApiKeysClient(this._options)));
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods list
+     * ```
+     *
      * @param {AgentMail.pods.ListPodsRequest} request
      * @param {PodsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -111,6 +116,11 @@ export class PodsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods retrieve --pod-id <pod_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {PodsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -173,6 +183,11 @@ export class PodsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods create --client-id my-pod
+     * ```
+     *
      * @param {AgentMail.pods.CreatePodRequest} request
      * @param {PodsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -241,6 +256,11 @@ export class PodsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods delete --pod-id <pod_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {PodsClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/esm/api/resources/pods/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 pods:api-keys list --pod-id <pod_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.pods.ListApiKeysRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -23,6 +28,11 @@ export declare class ApiKeysClient {
     list(pod_id: AgentMail.pods.PodId, request?: AgentMail.pods.ListApiKeysRequest, requestOptions?: ApiKeysClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListApiKeysResponse>;
     private __list;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:api-keys create --pod-id <pod_id> --name "My Key"
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_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.pods.apiKeys.create("pod_id", {
-     *         name: "name"
-     *     })
+     *     await client.pods.apiKeys.create("pod_id", {})
      */
     create(pod_id: AgentMail.pods.PodId, request: AgentMail.CreateApiKeyRequest, requestOptions?: ApiKeysClient.RequestOptions): core.HttpResponsePromise<AgentMail.CreateApiKeyResponse>;
     private __create;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:api-keys delete --pod-id <pod_id> --api-key-id <api_key_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.ApiKeyId} api_key_id
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -21,6 +21,11 @@ export class ApiKeysClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:api-keys list --pod-id <pod_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.pods.ListApiKeysRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -89,6 +94,11 @@ export class ApiKeysClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:api-keys create --pod-id <pod_id> --name "My Key"
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_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.pods.apiKeys.create("pod_id", {
-     *         name: "name"
-     *     })
+     *     await client.pods.apiKeys.create("pod_id", {})
      */
     create(pod_id, request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__create(pod_id, request, requestOptions));
@@ -169,6 +177,11 @@ export class ApiKeysClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:api-keys delete --pod-id <pod_id> --api-key-id <api_key_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.ApiKeyId} api_key_id
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/pods/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 pods:domains list --pod-id <pod_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.pods.ListDomainsRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -23,6 +28,11 @@ export declare class DomainsClient {
     list(pod_id: AgentMail.pods.PodId, request?: AgentMail.pods.ListDomainsRequest, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListDomainsResponse>;
     private __list;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:domains retrieve --pod-id <pod_id> --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -35,11 +45,21 @@ export declare class DomainsClient {
     get(pod_id: AgentMail.pods.PodId, domain_id: AgentMail.DomainId, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Domain>;
     private __get;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:domains get-zone-file --pod-id <pod_id> --domain-id <domain_id>
+     * ```
+     *
      * @throws {@link AgentMail.NotFoundError}
      */
     getZoneFile(pod_id: AgentMail.pods.PodId, domain_id: AgentMail.DomainId, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
     private __getZoneFile;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:domains create --pod-id <pod_id> --domain example.com
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.CreateDomainRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -55,6 +75,11 @@ export declare class DomainsClient {
     create(pod_id: AgentMail.pods.PodId, request: AgentMail.CreateDomainRequest, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Domain>;
     private __create;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:domains update --pod-id <pod_id> --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.DomainId} domain_id
      * @param {AgentMail.UpdateDomainRequest} request
@@ -68,6 +93,11 @@ export declare class DomainsClient {
     update(pod_id: AgentMail.pods.PodId, domain_id: AgentMail.DomainId, request: AgentMail.UpdateDomainRequest, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Domain>;
     private __update;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:domains delete --pod-id <pod_id> --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -80,6 +110,11 @@ export declare class DomainsClient {
     delete(pod_id: AgentMail.pods.PodId, domain_id: AgentMail.DomainId, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<void>;
     private __delete;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:domains verify --pod-id <pod_id> --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -21,6 +21,11 @@ export class DomainsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:domains list --pod-id <pod_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.pods.ListDomainsRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -90,6 +95,11 @@ export class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:domains retrieve --pod-id <pod_id> --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -153,6 +163,11 @@ export class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:domains get-zone-file --pod-id <pod_id> --domain-id <domain_id>
+     * ```
+     *
      * @throws {@link AgentMail.NotFoundError}
      */
     getZoneFile(pod_id, domain_id, requestOptions) {
@@ -201,6 +216,11 @@ export class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:domains create --pod-id <pod_id> --domain example.com
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.CreateDomainRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -273,6 +293,11 @@ export class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:domains update --pod-id <pod_id> --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.DomainId} domain_id
      * @param {AgentMail.UpdateDomainRequest} request
@@ -343,6 +368,11 @@ export class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:domains delete --pod-id <pod_id> --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -397,6 +427,11 @@ export class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:domains verify --pod-id <pod_id> --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/pods/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 pods:drafts list --pod-id <pod_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.pods.ListDraftsRequest} request
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -23,6 +28,11 @@ export declare class DraftsClient {
     list(pod_id: AgentMail.pods.PodId, request?: AgentMail.pods.ListDraftsRequest, requestOptions?: DraftsClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListDraftsResponse>;
     private __list;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:drafts retrieve --pod-id <pod_id> --draft-id <draft_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.DraftId} draft_id
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -35,6 +45,11 @@ export declare class DraftsClient {
     get(pod_id: AgentMail.pods.PodId, draft_id: AgentMail.DraftId, requestOptions?: DraftsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Draft>;
     private __get;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:drafts get-attachment --pod-id <pod_id> --draft-id <draft_id> --attachment-id <attachment_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.DraftId} draft_id
      * @param {AgentMail.AttachmentId} attachment_id

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

@@ -22,6 +22,11 @@ export class DraftsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:drafts list --pod-id <pod_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.pods.ListDraftsRequest} request
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -103,6 +108,11 @@ export class DraftsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:drafts retrieve --pod-id <pod_id> --draft-id <draft_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.DraftId} draft_id
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -166,6 +176,11 @@ export class DraftsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:drafts get-attachment --pod-id <pod_id> --draft-id <draft_id> --attachment-id <attachment_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.DraftId} draft_id
      * @param {AgentMail.AttachmentId} attachment_id

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

@@ -11,6 +11,11 @@ export declare class InboxesClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<InboxesClient.Options>;
     constructor(options?: InboxesClient.Options);
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:inboxes list --pod-id <pod_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.pods.ListInboxesRequest} request
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -23,6 +28,11 @@ export declare class InboxesClient {
     list(pod_id: AgentMail.pods.PodId, request?: AgentMail.pods.ListInboxesRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.ListInboxesResponse>;
     private __list;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:inboxes retrieve --pod-id <pod_id> --inbox-id <inbox_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -35,6 +45,11 @@ export declare class InboxesClient {
     get(pod_id: AgentMail.pods.PodId, inbox_id: AgentMail.inboxes.InboxId, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.Inbox>;
     private __get;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:inboxes create --pod-id <pod_id> --username myagent --domain example.com
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.inboxes.CreateInboxRequest} request
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -47,6 +62,11 @@ export declare class InboxesClient {
     create(pod_id: AgentMail.pods.PodId, request: AgentMail.inboxes.CreateInboxRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.Inbox>;
     private __create;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:inboxes update --pod-id <pod_id> --inbox-id <inbox_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {AgentMail.inboxes.UpdateInboxRequest} request
@@ -62,6 +82,11 @@ export declare class InboxesClient {
     update(pod_id: AgentMail.pods.PodId, inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.inboxes.UpdateInboxRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.Inbox>;
     private __update;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail pods:inboxes delete --pod-id <pod_id> --inbox-id <inbox_id>
+     * ```
+     *
      * @param {AgentMail.pods.PodId} pod_id
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.