smartletter 1.1.0 → 1.3.0

package/dist/index.d.mts

@@ -126,9 +126,9 @@ interface EmailsSendParams {
         contentId?: string;
     }[];
 }
-type EmailsSendResponse = {
+interface EmailsSendResponse {
     id: string;
-};
+}
 type BatchSendParams = {
     /**
      * `Name <address@your-domain>`; the domain must be verified. Required, except with a `template` that has one.
@@ -178,7 +178,7 @@ type BatchSendParams = {
      */
     topicId?: string | null;
 }[];
-type BatchSendResponse = {
+interface BatchSendResponse {
     data: {
         id: string;
     }[];
@@ -186,7 +186,7 @@ type BatchSendResponse = {
         index: number;
         message: string;
     }[];
-};
+}
 interface EmailsListParams {
     /**
      * 1–100, default 20.
@@ -201,11 +201,11 @@ interface EmailsListParams {
      */
     before?: string;
 }
-type EmailsListResponse = {
-    object: string;
+interface EmailsListResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "email";
         id: string;
         message_id: string | null;
         to: string[];
@@ -219,12 +219,12 @@ type EmailsListResponse = {
         scheduled_at: string | null;
         topic_id: string | null;
     }[];
-};
+}
 interface EmailsGetParams {
     id: string;
 }
-type EmailsGetResponse = {
-    object: string;
+interface EmailsGetResponse {
+    object: "email";
     id: string;
     message_id: string | null;
     to: string[];
@@ -243,18 +243,16 @@ type EmailsGetResponse = {
         name: string;
         value: string;
     }[];
-    status: string;
-    created_via: string;
-    attachments: {
-        filename: string;
-        content_type: string;
-        content_id: string | null;
-        size: number;
-    }[];
+    status: "scheduled" | "queued" | "sent" | "partially_failed" | "failed" | "canceled";
+    created_via: "api" | "mcp" | "smtp" | "inbox";
+    smtp?: {
+        client_ip: string | null;
+        message_id: string | null;
+    };
     recipients: {
         email: string;
-        type: string;
-        status: string;
+        type: "to" | "cc" | "bcc";
+        status: "queued" | "sent" | "delivered" | "delivery_delayed" | "bounced" | "complained" | "failed" | "suppressed" | "canceled";
         reason: string | null;
         bounce_type: string | null;
         smtp_status: string | null;
@@ -263,11 +261,13 @@ type EmailsGetResponse = {
         delay_expires_at: string | null;
         last_event_at: string | null;
     }[];
-    smtp?: {
-        client_ip: string | null;
-        message_id: string | null;
-    };
-};
+    attachments: {
+        filename: string;
+        content_type: string;
+        content_id: string | null;
+        size: number;
+    }[];
+}
 type EmailsUpdateParams = {
     id: string;
 } & {
@@ -276,17 +276,17 @@ type EmailsUpdateParams = {
      */
     scheduledAt: string;
 };
-type EmailsUpdateResponse = {
-    object: string;
+interface EmailsUpdateResponse {
+    object: "email";
     id: string;
-};
+}
 interface EmailsCancelParams {
     id: string;
 }
-type EmailsCancelResponse = {
-    object: string;
+interface EmailsCancelResponse {
+    object: "email";
     id: string;
-};
+}
 interface TemplatesCreateParams {
     name: string;
     /**
@@ -326,10 +326,10 @@ interface TemplatesCreateParams {
         required?: boolean;
     }[];
 }
-type TemplatesCreateResponse = {
-    object: string;
+interface TemplatesCreateResponse {
+    object: "template";
     id: string;
-};
+}
 interface TemplatesListParams {
     /**
      * 1–100, default 20.
@@ -344,25 +344,25 @@ interface TemplatesListParams {
      */
     before?: string;
 }
-type TemplatesListResponse = {
-    object: string;
+interface TemplatesListResponse {
+    object: "list";
     has_more: boolean;
     data: {
         id: string;
         name: string;
         alias: string | null;
-        status: string;
+        status: "draft" | "published";
         published_at: string | null;
         archived: boolean;
         created_at: string;
         updated_at: string;
     }[];
-};
+}
 interface TemplatesGetParams {
     id: string;
 }
-type TemplatesGetResponse = {
-    object: string;
+interface TemplatesGetResponse {
+    object: "template";
     id: string;
     current_version_id: string | null;
     current_version_number: number | null;
@@ -372,7 +372,7 @@ type TemplatesGetResponse = {
     name: string;
     created_at: string;
     updated_at: string;
-    status: string;
+    status: "draft" | "published";
     published_at: string | null;
     archived: boolean;
     from: string | null;
@@ -383,14 +383,14 @@ type TemplatesGetResponse = {
     variables: {
         id: string;
         key: string;
-        type: string;
+        type: "string" | "number";
         fallback_value: string | number | null;
         required: boolean;
         created_at: string;
         updated_at: string;
     }[];
     has_unpublished_versions: boolean;
-};
+}
 type TemplatesUpdateParams = {
     id: string;
 } & {
@@ -436,18 +436,18 @@ type TemplatesUpdateParams = {
      */
     changeNote?: string;
 };
-type TemplatesUpdateResponse = {
-    object: string;
+interface TemplatesUpdateResponse {
+    object: "template";
     id: string;
-};
+}
 interface TemplatesRemoveParams {
     id: string;
 }
-type TemplatesRemoveResponse = {
-    object: string;
+interface TemplatesRemoveResponse {
+    object: "template";
     id: string;
-    deleted: boolean;
-};
+    deleted: true;
+}
 type TemplatesPublishParams = {
     id: string;
 } & {
@@ -456,17 +456,17 @@ type TemplatesPublishParams = {
      */
     versionId?: string;
 };
-type TemplatesPublishResponse = {
-    object: string;
+interface TemplatesPublishResponse {
+    object: "template";
     id: string;
-};
+}
 interface TemplatesDuplicateParams {
     id: string;
 }
-type TemplatesDuplicateResponse = {
-    object: string;
+interface TemplatesDuplicateResponse {
+    object: "template";
     id: string;
-};
+}
 type TemplatesVersionsParams = {
     id: string;
 } & {
@@ -483,21 +483,21 @@ type TemplatesVersionsParams = {
      */
     before?: string;
 };
-type TemplatesVersionsResponse = {
-    object: string;
+interface TemplatesVersionsResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "template_version";
         id: string;
         number: number;
         subject: string | null;
-        source: string;
+        source: "html" | "doc";
         change_note: string | null;
-        created_via: string;
+        created_via: "api" | "mcp" | "dashboard";
         published: boolean;
         created_at: string;
     }[];
-};
+}
 interface NewslettersListParams {
     /**
      * 1–100, default 20.
@@ -511,38 +511,52 @@ interface NewslettersListParams {
      * Id of the first item of the previous page (newer items).
      */
     before?: string;
-    status?: "draft" | "scheduled" | "sending" | "paused" | "sent" | "failed" | "held";
+    status?: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
 }
-type NewslettersListResponse = {
-    object: string;
+interface NewslettersListResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "newsletter";
         id: string;
         segment_id: string;
-        topic_id: unknown;
+        topic_id: string | null;
         subject: string;
-        preheader: string;
-        status: string;
-        body: {
-            format: string;
-            content: unknown;
-            blocks: {
-                blockId: string;
-                kind: string;
-                text: string;
+        preheader: string | null;
+        status: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
+        kind: "newsletter" | "broadcast";
+        from: string;
+        audience_limit: number | null;
+        scheduled_for: string | null;
+        send_started_at: string | null;
+        send_finished_at: string | null;
+        pause_reason: ("manual" | "monthly_cap" | "auto_bounce_rate" | "auto_complaint_rate" | "test_batch_failed" | "workspace_suspended" | "plan_required" | "gmail_spam_rate" | "domain_required") | null;
+        recipient_estimate: number | null;
+        ab_test: {
+            variants: {
+                key: "A" | "B" | "C" | "D";
+                subject: string;
+                preheader: string | null;
             }[];
+            sample_pct: number;
+            metric: "opens" | "clicks";
+            wait_hours: number;
+            winner_mode: "auto" | "manual";
+        } | null;
+        ab_winner: ("A" | "B" | "C" | "D") | null;
+        stats: {
+            sent: number;
+            delivered: number;
+            opened: number;
+            clicked: number;
+            bounced: number;
+            complained: number;
+            unsubscribed: number;
         };
-        audience_limit: unknown;
-        scheduled_for: unknown;
-        pause_reason: unknown;
-        recipient_estimate: unknown;
-        ab_test: unknown;
-        ab_winner: unknown;
         created_at: string;
         updated_at: string;
     }[];
-};
+}
 interface NewslettersCreateParams {
     /**
      * Subject line.
@@ -683,68 +697,137 @@ interface NewslettersCreateParams {
          */
         winnerMode?: "auto" | "manual";
     } | null;
+    /**
+     * `newsletter` (default) goes to the subscribers of the newsletter, or of a topic. `broadcast` goes to the contacts of the group (the rule `audience_filter_id` narrows it), subscribed or not, and takes no `topic_id`. A broadcast is never published in the archive.
+     */
+    kind?: "newsletter" | "broadcast";
+    /**
+     * Sender address of this issue: `name@your-domain.com`, on the custom domain of the newsletter (a bare local part `name` also works). Omit or `null` for the address of the newsletter.
+     */
+    from?: string | null;
 }
-type NewslettersCreateResponse = {
-    object: string;
+interface NewslettersCreateResponse {
+    object: "newsletter";
     id: string;
     segment_id: string;
-    topic_id: unknown;
+    topic_id: string | null;
     subject: string;
-    preheader: string;
-    status: string;
+    preheader: string | null;
+    status: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
+    kind: "newsletter" | "broadcast";
+    from: string;
     body: {
-        format: string;
-        content: unknown;
+        format: "markdown" | "html";
+        content: string;
+    } | {
+        format: "sections";
+        content: null;
+    } | {
+        format: "document";
+        content: null;
         blocks: {
-            blockId: string;
+            block_id: string;
             kind: string;
             text: string;
         }[];
     };
-    audience_limit: unknown;
-    scheduled_for: unknown;
-    pause_reason: unknown;
-    recipient_estimate: unknown;
-    ab_test: unknown;
-    ab_winner: unknown;
+    audience_limit: number | null;
+    scheduled_for: string | null;
+    send_started_at: string | null;
+    send_finished_at: string | null;
+    pause_reason: ("manual" | "monthly_cap" | "auto_bounce_rate" | "auto_complaint_rate" | "test_batch_failed" | "workspace_suspended" | "plan_required" | "gmail_spam_rate" | "domain_required") | null;
+    recipient_estimate: number | null;
+    ab_test: {
+        variants: {
+            key: "A" | "B" | "C" | "D";
+            subject: string;
+            preheader: string | null;
+        }[];
+        sample_pct: number;
+        metric: "opens" | "clicks";
+        wait_hours: number;
+        winner_mode: "auto" | "manual";
+    } | null;
+    ab_winner: ("A" | "B" | "C" | "D") | null;
+    stats: {
+        sent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+        unsubscribed: number;
+    };
     created_at: string;
     updated_at: string;
-};
+}
 interface NewslettersGetParams {
     id: string;
 }
-type NewslettersGetResponse = {
-    object: string;
+interface NewslettersGetResponse {
+    object: "newsletter";
     id: string;
     segment_id: string;
-    topic_id: unknown;
+    topic_id: string | null;
     subject: string;
-    preheader: string;
-    status: string;
+    preheader: string | null;
+    status: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
+    kind: "newsletter" | "broadcast";
+    from: string;
     body: {
-        format: string;
-        content: unknown;
+        format: "markdown" | "html";
+        content: string;
+    } | {
+        format: "sections";
+        content: null;
+    } | {
+        format: "document";
+        content: null;
         blocks: {
-            blockId: string;
+            block_id: string;
             kind: string;
             text: string;
         }[];
     };
-    audience_limit: unknown;
-    scheduled_for: unknown;
-    pause_reason: unknown;
-    recipient_estimate: unknown;
-    ab_test: unknown;
-    ab_winner: unknown;
+    audience_limit: number | null;
+    scheduled_for: string | null;
+    send_started_at: string | null;
+    send_finished_at: string | null;
+    pause_reason: ("manual" | "monthly_cap" | "auto_bounce_rate" | "auto_complaint_rate" | "test_batch_failed" | "workspace_suspended" | "plan_required" | "gmail_spam_rate" | "domain_required") | null;
+    recipient_estimate: number | null;
+    ab_test: {
+        variants: {
+            key: "A" | "B" | "C" | "D";
+            subject: string;
+            preheader: string | null;
+        }[];
+        sample_pct: number;
+        metric: "opens" | "clicks";
+        wait_hours: number;
+        winner_mode: "auto" | "manual";
+    } | null;
+    ab_winner: ("A" | "B" | "C" | "D") | null;
+    stats: {
+        sent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+        unsubscribed: number;
+    };
     created_at: string;
     updated_at: string;
-};
+}
 type NewslettersUpdateParams = {
     id: string;
 } & {
     subject?: string;
     preheader?: string | null;
-    topicId?: string;
+    /**
+     * Topic of the issue. `null` is accepted only for a broadcast, which has no topic.
+     */
+    topicId?: string | null;
     markdown?: string;
     html?: string;
     /**
@@ -862,91 +945,164 @@ type NewslettersUpdateParams = {
          */
         winnerMode?: "auto" | "manual";
     } | null;
+    /**
+     * Drafts only. See `POST /newsletters`.
+     */
+    kind?: "newsletter" | "broadcast";
+    /**
+     * Sender address of this issue; `null` goes back to the address of the newsletter.
+     */
+    from?: string | null;
 };
-type NewslettersUpdateResponse = {
-    object: string;
+interface NewslettersUpdateResponse {
+    object: "newsletter";
     id: string;
     segment_id: string;
-    topic_id: unknown;
+    topic_id: string | null;
     subject: string;
-    preheader: string;
-    status: string;
+    preheader: string | null;
+    status: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
+    kind: "newsletter" | "broadcast";
+    from: string;
     body: {
-        format: string;
-        content: unknown;
+        format: "markdown" | "html";
+        content: string;
+    } | {
+        format: "sections";
+        content: null;
+    } | {
+        format: "document";
+        content: null;
         blocks: {
-            blockId: string;
+            block_id: string;
             kind: string;
             text: string;
         }[];
     };
-    audience_limit: unknown;
-    scheduled_for: unknown;
-    pause_reason: unknown;
-    recipient_estimate: unknown;
-    ab_test: unknown;
-    ab_winner: unknown;
+    audience_limit: number | null;
+    scheduled_for: string | null;
+    send_started_at: string | null;
+    send_finished_at: string | null;
+    pause_reason: ("manual" | "monthly_cap" | "auto_bounce_rate" | "auto_complaint_rate" | "test_batch_failed" | "workspace_suspended" | "plan_required" | "gmail_spam_rate" | "domain_required") | null;
+    recipient_estimate: number | null;
+    ab_test: {
+        variants: {
+            key: "A" | "B" | "C" | "D";
+            subject: string;
+            preheader: string | null;
+        }[];
+        sample_pct: number;
+        metric: "opens" | "clicks";
+        wait_hours: number;
+        winner_mode: "auto" | "manual";
+    } | null;
+    ab_winner: ("A" | "B" | "C" | "D") | null;
+    stats: {
+        sent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+        unsubscribed: number;
+    };
     created_at: string;
     updated_at: string;
-};
+}
 interface NewslettersRemoveParams {
     id: string;
 }
-type NewslettersRemoveResponse = {
-    object: string;
+interface NewslettersRemoveResponse {
+    object: "newsletter";
     id: string;
-    deleted: boolean;
-};
+    deleted: true;
+}
 interface NewslettersDuplicateParams {
     id: string;
 }
-type NewslettersDuplicateResponse = {
-    object: string;
+interface NewslettersDuplicateResponse {
+    object: "newsletter";
     id: string;
     segment_id: string;
-    topic_id: unknown;
+    topic_id: string | null;
     subject: string;
-    preheader: string;
-    status: string;
+    preheader: string | null;
+    status: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
+    kind: "newsletter" | "broadcast";
+    from: string;
     body: {
-        format: string;
-        content: unknown;
+        format: "markdown" | "html";
+        content: string;
+    } | {
+        format: "sections";
+        content: null;
+    } | {
+        format: "document";
+        content: null;
         blocks: {
-            blockId: string;
+            block_id: string;
             kind: string;
             text: string;
         }[];
     };
-    audience_limit: unknown;
-    scheduled_for: unknown;
-    pause_reason: unknown;
-    recipient_estimate: unknown;
-    ab_test: unknown;
-    ab_winner: unknown;
+    audience_limit: number | null;
+    scheduled_for: string | null;
+    send_started_at: string | null;
+    send_finished_at: string | null;
+    pause_reason: ("manual" | "monthly_cap" | "auto_bounce_rate" | "auto_complaint_rate" | "test_batch_failed" | "workspace_suspended" | "plan_required" | "gmail_spam_rate" | "domain_required") | null;
+    recipient_estimate: number | null;
+    ab_test: {
+        variants: {
+            key: "A" | "B" | "C" | "D";
+            subject: string;
+            preheader: string | null;
+        }[];
+        sample_pct: number;
+        metric: "opens" | "clicks";
+        wait_hours: number;
+        winner_mode: "auto" | "manual";
+    } | null;
+    ab_winner: ("A" | "B" | "C" | "D") | null;
+    stats: {
+        sent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+        unsubscribed: number;
+    };
     created_at: string;
     updated_at: string;
-};
+}
 interface NewslettersReviewParams {
     id: string;
 }
-type NewslettersReviewResponse = {
-    object: string;
+interface NewslettersReviewResponse {
+    object: "review";
+    id: string;
     blocking: boolean;
     items: {
-        id: string;
-        level: string;
+        id: "subject" | "preheader" | "unsubscribe" | "postal_address" | "size" | "links" | "images_alt" | "domain" | "content" | "html_size" | "variables";
+        level: "ok" | "warning" | "blocking";
         values?: {
-            kb: number;
+            max?: number;
+            length?: number;
+            kb?: number;
+            count?: number;
+            percent?: number;
         };
     }[];
-};
+}
 interface NewslettersTestParams {
     id: string;
 }
-type NewslettersTestResponse = {
-    object: string;
+interface NewslettersTestResponse {
+    object: "test_email";
+    id: string;
     to: string;
-};
+    variants: number;
+}
 type NewslettersSendParams = {
     id: string;
 } & {
@@ -955,11 +1111,61 @@ type NewslettersSendParams = {
      */
     audienceLimit?: number;
 };
-type NewslettersSendResponse = {
-    object: string;
+interface NewslettersSendResponse {
+    object: "newsletter";
     id: string;
-    status: string;
-};
+    segment_id: string;
+    topic_id: string | null;
+    subject: string;
+    preheader: string | null;
+    status: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
+    kind: "newsletter" | "broadcast";
+    from: string;
+    body: {
+        format: "markdown" | "html";
+        content: string;
+    } | {
+        format: "sections";
+        content: null;
+    } | {
+        format: "document";
+        content: null;
+        blocks: {
+            block_id: string;
+            kind: string;
+            text: string;
+        }[];
+    };
+    audience_limit: number | null;
+    scheduled_for: string | null;
+    send_started_at: string | null;
+    send_finished_at: string | null;
+    pause_reason: ("manual" | "monthly_cap" | "auto_bounce_rate" | "auto_complaint_rate" | "test_batch_failed" | "workspace_suspended" | "plan_required" | "gmail_spam_rate" | "domain_required") | null;
+    recipient_estimate: number | null;
+    ab_test: {
+        variants: {
+            key: "A" | "B" | "C" | "D";
+            subject: string;
+            preheader: string | null;
+        }[];
+        sample_pct: number;
+        metric: "opens" | "clicks";
+        wait_hours: number;
+        winner_mode: "auto" | "manual";
+    } | null;
+    ab_winner: ("A" | "B" | "C" | "D") | null;
+    stats: {
+        sent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+        unsubscribed: number;
+    };
+    created_at: string;
+    updated_at: string;
+}
 type NewslettersScheduleParams = {
     id: string;
 } & {
@@ -972,57 +1178,50 @@ type NewslettersScheduleParams = {
      */
     audienceLimit?: number;
 };
-type NewslettersScheduleResponse = {
-    object: string;
-    id: string;
-    status: string;
-    scheduled_for: string;
-};
-interface NewslettersUnscheduleParams {
-    id: string;
-}
-type NewslettersUnscheduleResponse = {
-    object: string;
-    id: string;
-    status: string;
-};
-interface NewslettersPauseParams {
-    id: string;
-}
-type NewslettersPauseResponse = {
-    object: string;
-    id: string;
-    status: string;
-};
-interface NewslettersResumeParams {
-    id: string;
-}
-type NewslettersResumeResponse = {
-    object: string;
-    id: string;
-    status: string;
-};
-type NewslettersSendMoreParams = {
-    id: string;
-} & {
-    /**
-     * How many of the next most engaged contacts to add.
-     */
-    count: number;
-};
-type NewslettersSendMoreResponse = {
-    object: string;
-    id: string;
-    status: string;
-};
-interface NewslettersReportParams {
+interface NewslettersScheduleResponse {
+    object: "newsletter";
     id: string;
-}
-type NewslettersReportResponse = {
-    object: string;
-    id: string;
-    status: string;
-    totals: {
+    segment_id: string;
+    topic_id: string | null;
+    subject: string;
+    preheader: string | null;
+    status: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
+    kind: "newsletter" | "broadcast";
+    from: string;
+    body: {
+        format: "markdown" | "html";
+        content: string;
+    } | {
+        format: "sections";
+        content: null;
+    } | {
+        format: "document";
+        content: null;
+        blocks: {
+            block_id: string;
+            kind: string;
+            text: string;
+        }[];
+    };
+    audience_limit: number | null;
+    scheduled_for: string | null;
+    send_started_at: string | null;
+    send_finished_at: string | null;
+    pause_reason: ("manual" | "monthly_cap" | "auto_bounce_rate" | "auto_complaint_rate" | "test_batch_failed" | "workspace_suspended" | "plan_required" | "gmail_spam_rate" | "domain_required") | null;
+    recipient_estimate: number | null;
+    ab_test: {
+        variants: {
+            key: "A" | "B" | "C" | "D";
+            subject: string;
+            preheader: string | null;
+        }[];
+        sample_pct: number;
+        metric: "opens" | "clicks";
+        wait_hours: number;
+        winner_mode: "auto" | "manual";
+    } | null;
+    ab_winner: ("A" | "B" | "C" | "D") | null;
+    stats: {
         sent: number;
         delivered: number;
         opened: number;
@@ -1031,21 +1230,277 @@ type NewslettersReportResponse = {
         complained: number;
         unsubscribed: number;
     };
-    rates: {
-        delivery: number;
-        open: number;
-        click: number;
-        bounce: number;
+    created_at: string;
+    updated_at: string;
+}
+interface NewslettersUnscheduleParams {
+    id: string;
+}
+interface NewslettersUnscheduleResponse {
+    object: "newsletter";
+    id: string;
+    segment_id: string;
+    topic_id: string | null;
+    subject: string;
+    preheader: string | null;
+    status: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
+    kind: "newsletter" | "broadcast";
+    from: string;
+    body: {
+        format: "markdown" | "html";
+        content: string;
+    } | {
+        format: "sections";
+        content: null;
+    } | {
+        format: "document";
+        content: null;
+        blocks: {
+            block_id: string;
+            kind: string;
+            text: string;
+        }[];
+    };
+    audience_limit: number | null;
+    scheduled_for: string | null;
+    send_started_at: string | null;
+    send_finished_at: string | null;
+    pause_reason: ("manual" | "monthly_cap" | "auto_bounce_rate" | "auto_complaint_rate" | "test_batch_failed" | "workspace_suspended" | "plan_required" | "gmail_spam_rate" | "domain_required") | null;
+    recipient_estimate: number | null;
+    ab_test: {
+        variants: {
+            key: "A" | "B" | "C" | "D";
+            subject: string;
+            preheader: string | null;
+        }[];
+        sample_pct: number;
+        metric: "opens" | "clicks";
+        wait_hours: number;
+        winner_mode: "auto" | "manual";
+    } | null;
+    ab_winner: ("A" | "B" | "C" | "D") | null;
+    stats: {
+        sent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+        unsubscribed: number;
+    };
+    created_at: string;
+    updated_at: string;
+}
+interface NewslettersPauseParams {
+    id: string;
+}
+interface NewslettersPauseResponse {
+    object: "newsletter";
+    id: string;
+    segment_id: string;
+    topic_id: string | null;
+    subject: string;
+    preheader: string | null;
+    status: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
+    kind: "newsletter" | "broadcast";
+    from: string;
+    body: {
+        format: "markdown" | "html";
+        content: string;
+    } | {
+        format: "sections";
+        content: null;
+    } | {
+        format: "document";
+        content: null;
+        blocks: {
+            block_id: string;
+            kind: string;
+            text: string;
+        }[];
+    };
+    audience_limit: number | null;
+    scheduled_for: string | null;
+    send_started_at: string | null;
+    send_finished_at: string | null;
+    pause_reason: ("manual" | "monthly_cap" | "auto_bounce_rate" | "auto_complaint_rate" | "test_batch_failed" | "workspace_suspended" | "plan_required" | "gmail_spam_rate" | "domain_required") | null;
+    recipient_estimate: number | null;
+    ab_test: {
+        variants: {
+            key: "A" | "B" | "C" | "D";
+            subject: string;
+            preheader: string | null;
+        }[];
+        sample_pct: number;
+        metric: "opens" | "clicks";
+        wait_hours: number;
+        winner_mode: "auto" | "manual";
+    } | null;
+    ab_winner: ("A" | "B" | "C" | "D") | null;
+    stats: {
+        sent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+        unsubscribed: number;
+    };
+    created_at: string;
+    updated_at: string;
+}
+interface NewslettersResumeParams {
+    id: string;
+}
+interface NewslettersResumeResponse {
+    object: "newsletter";
+    id: string;
+    segment_id: string;
+    topic_id: string | null;
+    subject: string;
+    preheader: string | null;
+    status: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
+    kind: "newsletter" | "broadcast";
+    from: string;
+    body: {
+        format: "markdown" | "html";
+        content: string;
+    } | {
+        format: "sections";
+        content: null;
+    } | {
+        format: "document";
+        content: null;
+        blocks: {
+            block_id: string;
+            kind: string;
+            text: string;
+        }[];
+    };
+    audience_limit: number | null;
+    scheduled_for: string | null;
+    send_started_at: string | null;
+    send_finished_at: string | null;
+    pause_reason: ("manual" | "monthly_cap" | "auto_bounce_rate" | "auto_complaint_rate" | "test_batch_failed" | "workspace_suspended" | "plan_required" | "gmail_spam_rate" | "domain_required") | null;
+    recipient_estimate: number | null;
+    ab_test: {
+        variants: {
+            key: "A" | "B" | "C" | "D";
+            subject: string;
+            preheader: string | null;
+        }[];
+        sample_pct: number;
+        metric: "opens" | "clicks";
+        wait_hours: number;
+        winner_mode: "auto" | "manual";
+    } | null;
+    ab_winner: ("A" | "B" | "C" | "D") | null;
+    stats: {
+        sent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+        unsubscribed: number;
+    };
+    created_at: string;
+    updated_at: string;
+}
+type NewslettersSendMoreParams = {
+    id: string;
+} & {
+    /**
+     * How many of the next most engaged contacts to add.
+     */
+    count: number;
+};
+interface NewslettersSendMoreResponse {
+    object: "newsletter";
+    id: string;
+    segment_id: string;
+    topic_id: string | null;
+    subject: string;
+    preheader: string | null;
+    status: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
+    kind: "newsletter" | "broadcast";
+    from: string;
+    body: {
+        format: "markdown" | "html";
+        content: string;
+    } | {
+        format: "sections";
+        content: null;
+    } | {
+        format: "document";
+        content: null;
+        blocks: {
+            block_id: string;
+            kind: string;
+            text: string;
+        }[];
+    };
+    audience_limit: number | null;
+    scheduled_for: string | null;
+    send_started_at: string | null;
+    send_finished_at: string | null;
+    pause_reason: ("manual" | "monthly_cap" | "auto_bounce_rate" | "auto_complaint_rate" | "test_batch_failed" | "workspace_suspended" | "plan_required" | "gmail_spam_rate" | "domain_required") | null;
+    recipient_estimate: number | null;
+    ab_test: {
+        variants: {
+            key: "A" | "B" | "C" | "D";
+            subject: string;
+            preheader: string | null;
+        }[];
+        sample_pct: number;
+        metric: "opens" | "clicks";
+        wait_hours: number;
+        winner_mode: "auto" | "manual";
+    } | null;
+    ab_winner: ("A" | "B" | "C" | "D") | null;
+    stats: {
+        sent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+        unsubscribed: number;
+    };
+    created_at: string;
+    updated_at: string;
+}
+interface NewslettersReportParams {
+    id: string;
+}
+interface NewslettersReportResponse {
+    object: "report";
+    id: string;
+    status: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
+    totals: {
+        sent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+        unsubscribed: number;
+    };
+    rates: {
+        delivery: number;
+        open: number;
+        click: number;
+        bounce: number;
         complaint: number;
         unsubscribe: number;
     };
     progress: {
-        attempted: number;
-        recipient_estimate: number;
-        audience_limit: unknown;
+        attempted: number | null;
+        recipient_estimate: number | null;
+        audience_limit: number | null;
     };
     providers: {
-        provider: string;
+        provider: "gmail" | "microsoft" | "yahoo" | "apple" | "fr_isp" | "gmx" | "proton" | "other";
         sent: number;
         delivered: number;
         opened: number;
@@ -1054,19 +1509,19 @@ type NewslettersReportResponse = {
         complained: number;
     }[];
     ab_test: {
-        phase: string;
+        phase: ("testing" | "waiting" | "winner") | null;
         sample_pct: number;
-        metric: string;
+        metric: "opens" | "clicks";
         wait_hours: number;
-        winner_mode: string;
-        winner: unknown;
-        decided_at: unknown;
-        decided_by: unknown;
-        decide_at: string;
+        winner_mode: "auto" | "manual";
+        winner: ("A" | "B" | "C" | "D") | null;
+        decided_at: string | null;
+        decided_by: ("auto" | "manual" | "fallback" | "skipped") | null;
+        decide_at: string | null;
         variants: {
-            key: string;
+            key: "A" | "B" | "C" | "D";
             subject: string;
-            preheader: string;
+            preheader: string | null;
             total: {
                 attempted: number;
                 sent: number;
@@ -1079,13 +1534,9 @@ type NewslettersReportResponse = {
             };
         }[];
         report: {
-            metric: string;
-            leader: string;
-            winner: unknown;
-            p_value: number;
-            significant: boolean;
+            metric: "opens" | "clicks";
             variants: {
-                variant: string;
+                variant: "A" | "B" | "C" | "D";
                 sent: number;
                 opened: number;
                 clicked: number;
@@ -1095,17 +1546,21 @@ type NewslettersReportResponse = {
                 ci_high: number;
                 leader: boolean;
             }[];
+            leader: "A" | "B" | "C" | "D";
+            winner: ("A" | "B" | "C" | "D") | null;
+            p_value: number;
+            significant: boolean;
         };
-    };
+    } | null;
     links: {
         url: string;
-        label: string;
+        label: string | null;
         clicks: number;
         unique_clickers: number;
         share: number;
     }[];
     links_total: number;
-};
+}
 type NewslettersAbWinnerParams = {
     id: string;
 } & {
@@ -1114,32 +1569,61 @@ type NewslettersAbWinnerParams = {
      */
     variant: "A" | "B" | "C" | "D";
 };
-type NewslettersAbWinnerResponse = {
-    object: string;
+interface NewslettersAbWinnerResponse {
+    object: "newsletter";
     id: string;
     segment_id: string;
-    topic_id: unknown;
+    topic_id: string | null;
     subject: string;
-    preheader: string;
-    status: string;
+    preheader: string | null;
+    status: "draft" | "scheduled" | "sending" | "sent" | "paused" | "cancelled" | "held";
+    kind: "newsletter" | "broadcast";
+    from: string;
     body: {
-        format: string;
-        content: unknown;
+        format: "markdown" | "html";
+        content: string;
+    } | {
+        format: "sections";
+        content: null;
+    } | {
+        format: "document";
+        content: null;
         blocks: {
-            blockId: string;
+            block_id: string;
             kind: string;
             text: string;
         }[];
     };
-    audience_limit: unknown;
-    scheduled_for: unknown;
-    pause_reason: unknown;
-    recipient_estimate: unknown;
-    ab_test: unknown;
-    ab_winner: string;
+    audience_limit: number | null;
+    scheduled_for: string | null;
+    send_started_at: string | null;
+    send_finished_at: string | null;
+    pause_reason: ("manual" | "monthly_cap" | "auto_bounce_rate" | "auto_complaint_rate" | "test_batch_failed" | "workspace_suspended" | "plan_required" | "gmail_spam_rate" | "domain_required") | null;
+    recipient_estimate: number | null;
+    ab_test: {
+        variants: {
+            key: "A" | "B" | "C" | "D";
+            subject: string;
+            preheader: string | null;
+        }[];
+        sample_pct: number;
+        metric: "opens" | "clicks";
+        wait_hours: number;
+        winner_mode: "auto" | "manual";
+    } | null;
+    ab_winner: ("A" | "B" | "C" | "D") | null;
+    stats: {
+        sent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+        unsubscribed: number;
+    };
     created_at: string;
     updated_at: string;
-};
+}
 interface ContactsListParams {
     /**
      * 1–100, default 20.
@@ -1164,17 +1648,37 @@ interface ContactsListParams {
      */
     tag?: string;
 }
-type ContactsListResponse = {
-    object: string;
+interface ContactsListResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "contact";
         id: string;
         email: string;
-        status: string;
+        name: string | null;
+        first_name: string | null;
+        last_name: string | null;
+        status: "active" | "pending" | "unsubscribed" | "bounced" | "complained" | "dormant";
         segment_id: string;
+        language: string | null;
+        source: "unknown" | "lead_magnet" | "import" | "api" | "signup_form" | "admin" | "shopify" | "woocommerce";
+        subscribed_at: string | null;
+        unsubscribed_at: string | null;
+        created_at: string;
+        custom_fields: {
+            [k: string]: string | number | boolean;
+        };
+        tags: string[];
+        newsletter_subscribed: boolean;
+        engagement: {
+            emails_sent: number;
+            emails_opened: number;
+            emails_clicked: number;
+            last_opened_at: string | null;
+            last_clicked_at: string | null;
+        };
     }[];
-};
+}
 interface ContactsCreateParams {
     email: string;
     /**
@@ -1198,14 +1702,39 @@ interface ContactsCreateParams {
      * Added to the contact's tags (also when the contact already exists).
      */
     tags?: string[];
+    /**
+     * Receives the newsletter issues (default `true` for a new contact). `false` adds the contact to the group only: they get broadcasts, not newsletters. A contact already in the group is never unsubscribed here: only `true` subscribes them.
+     */
+    newsletterSubscribed?: boolean;
 }
-type ContactsCreateResponse = {
-    object: string;
+interface ContactsCreateResponse {
+    object: "contact";
     id: string;
     email: string;
-    status: string;
+    name: string | null;
+    first_name: string | null;
+    last_name: string | null;
+    status: "active" | "pending" | "unsubscribed" | "bounced" | "complained" | "dormant";
+    segment_id: string;
+    language: string | null;
+    source: "unknown" | "lead_magnet" | "import" | "api" | "signup_form" | "admin" | "shopify" | "woocommerce";
+    subscribed_at: string | null;
+    unsubscribed_at: string | null;
+    created_at: string;
+    custom_fields: {
+        [k: string]: string | number | boolean;
+    };
+    tags: string[];
+    newsletter_subscribed: boolean;
+    engagement: {
+        emails_sent: number;
+        emails_opened: number;
+        emails_clicked: number;
+        last_opened_at: string | null;
+        last_clicked_at: string | null;
+    };
     existed: boolean;
-};
+}
 interface ContactsImportParams {
     segmentId?: string;
     /**
@@ -1240,6 +1769,10 @@ interface ContactsImportParams {
          * Merged into the tags of a contact already in the newsletter (never replaced).
          */
         tags?: string[] | null;
+        /**
+         * New contact: default `true`. `false` keeps them in the group only. A contact already in the group changes only with an explicit `true`.
+         */
+        newsletterSubscribed?: boolean | null;
         /**
          * `unsubscribed` keeps a contact who left on your previous platform: stored unsubscribed, never emailed, and a contact already in the newsletter is unsubscribed too. Default `active`.
          */
@@ -1250,13 +1783,14 @@ interface ContactsImportParams {
         unsubscribedAt?: string | null;
     }[];
 }
-type ContactsImportResponse = {
-    object: string;
+interface ContactsImportResponse {
+    object: "import";
     total: number;
     inserted: number;
     rejected: number;
     reasons: {
-        invalid: number;
+        invalid_syntax: number;
+        source_unsubscribed: number;
         typo: number;
         spam_trap: number;
         role: number;
@@ -1269,11 +1803,18 @@ type ContactsImportResponse = {
     rejected_rows: {
         line: number;
         email: string;
-        reason: string;
+        reason: "invalid_syntax" | "source_unsubscribed" | "typo" | "spam_trap" | "role" | "disposable" | "no_mx" | "duplicate" | "suppressed" | "capped";
         suggestion?: string;
     }[];
+    report_truncated: boolean;
+    engagement_imported: number;
+    capped: boolean;
+    remaining_capacity: number | null;
     pending_review: boolean;
-};
+    verifying: boolean;
+    tagged: number;
+    unsubscribed: number;
+}
 interface ContactsExportParams {
     segmentId?: string;
     status?: "active" | "pending" | "unsubscribed" | "bounced" | "complained" | "dormant";
@@ -1282,49 +1823,109 @@ type ContactsExportResponse = string;
 interface ContactsGetParams {
     id: string;
 }
-type ContactsGetResponse = {
-    object: string;
+interface ContactsGetResponse {
+    object: "contact";
     id: string;
     email: string;
-    status: string;
+    name: string | null;
+    first_name: string | null;
+    last_name: string | null;
+    status: "active" | "pending" | "unsubscribed" | "bounced" | "complained" | "dormant";
+    segment_id: string;
+    language: string | null;
+    source: "unknown" | "lead_magnet" | "import" | "api" | "signup_form" | "admin" | "shopify" | "woocommerce";
+    subscribed_at: string | null;
+    unsubscribed_at: string | null;
+    created_at: string;
+    custom_fields: {
+        [k: string]: string | number | boolean;
+    };
+    tags: string[];
+    newsletter_subscribed: boolean;
     engagement: {
         emails_sent: number;
         emails_opened: number;
         emails_clicked: number;
+        last_opened_at: string | null;
+        last_clicked_at: string | null;
     };
     status_history: {
         at: string;
-        from_status: string;
-        to_status: string;
-        source: string;
+        from_status: ("active" | "pending" | "unsubscribed" | "bounced" | "complained" | "dormant") | null;
+        to_status: "active" | "pending" | "unsubscribed" | "bounced" | "complained" | "dormant";
+        source: "signup" | "confirm" | "unsubscribe_link" | "list_unsubscribe" | "bounce" | "complaint" | "dormant_cleanup" | "keep_click" | "suppression_expired" | "import" | "import_verification" | "admin" | "dashboard" | "api" | "mcp" | "resubscribe" | "commerce" | "integration" | "unknown";
         actor: string;
-        detail: unknown;
+        detail: string | null;
     }[];
-};
+}
 interface ContactsUnsubscribeParams {
     id: string;
 }
-type ContactsUnsubscribeResponse = {
-    object: string;
+interface ContactsUnsubscribeResponse {
+    object: "contact";
     id: string;
-    status: string;
-};
+    email: string;
+    name: string | null;
+    first_name: string | null;
+    last_name: string | null;
+    status: "active" | "pending" | "unsubscribed" | "bounced" | "complained" | "dormant";
+    segment_id: string;
+    language: string | null;
+    source: "unknown" | "lead_magnet" | "import" | "api" | "signup_form" | "admin" | "shopify" | "woocommerce";
+    subscribed_at: string | null;
+    unsubscribed_at: string | null;
+    created_at: string;
+    custom_fields: {
+        [k: string]: string | number | boolean;
+    };
+    tags: string[];
+    newsletter_subscribed: boolean;
+    engagement: {
+        emails_sent: number;
+        emails_opened: number;
+        emails_clicked: number;
+        last_opened_at: string | null;
+        last_clicked_at: string | null;
+    };
+}
 interface ContactsReactivateParams {
     id: string;
 }
-type ContactsReactivateResponse = {
-    object: string;
+interface ContactsReactivateResponse {
+    object: "contact";
     id: string;
-    status: string;
-};
+    email: string;
+    name: string | null;
+    first_name: string | null;
+    last_name: string | null;
+    status: "active" | "pending" | "unsubscribed" | "bounced" | "complained" | "dormant";
+    segment_id: string;
+    language: string | null;
+    source: "unknown" | "lead_magnet" | "import" | "api" | "signup_form" | "admin" | "shopify" | "woocommerce";
+    subscribed_at: string | null;
+    unsubscribed_at: string | null;
+    created_at: string;
+    custom_fields: {
+        [k: string]: string | number | boolean;
+    };
+    tags: string[];
+    newsletter_subscribed: boolean;
+    engagement: {
+        emails_sent: number;
+        emails_opened: number;
+        emails_clicked: number;
+        last_opened_at: string | null;
+        last_clicked_at: string | null;
+    };
+}
 interface ContactsRemoveParams {
     id: string;
 }
-type ContactsRemoveResponse = {
-    object: string;
+interface ContactsRemoveResponse {
+    object: "contact";
     id: string;
-    deleted: boolean;
-};
+    deleted: true;
+}
 type ContactsUpdateParams = {
     id: string;
 } & {
@@ -1350,32 +1951,55 @@ type ContactsUpdateParams = {
      * Removed from the current tags.
      */
     removeTags?: string[];
+    /**
+     * `true` subscribes the contact to the newsletter issues, `false` keeps them in the group only (broadcasts still reach them).
+     */
+    newsletterSubscribed?: boolean;
 };
-type ContactsUpdateResponse = {
-    object: string;
+interface ContactsUpdateResponse {
+    object: "contact";
     id: string;
-    first_name: string;
+    email: string;
+    name: string | null;
+    first_name: string | null;
+    last_name: string | null;
+    status: "active" | "pending" | "unsubscribed" | "bounced" | "complained" | "dormant";
+    segment_id: string;
+    language: string | null;
+    source: "unknown" | "lead_magnet" | "import" | "api" | "signup_form" | "admin" | "shopify" | "woocommerce";
+    subscribed_at: string | null;
+    unsubscribed_at: string | null;
+    created_at: string;
     custom_fields: {
-        plan: string;
+        [k: string]: string | number | boolean;
     };
-};
+    tags: string[];
+    newsletter_subscribed: boolean;
+    engagement: {
+        emails_sent: number;
+        emails_opened: number;
+        emails_clicked: number;
+        last_opened_at: string | null;
+        last_clicked_at: string | null;
+    };
+}
 type ContactFieldsListParams = Record<string, never>;
-type ContactFieldsListResponse = {
-    object: string;
+interface ContactFieldsListResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "contact_field";
         id: string;
         key: string;
         label: string;
-        type: string;
-        options: string[];
-        default_value: unknown;
+        type: "text" | "number" | "date" | "boolean" | "choice";
+        options: string[] | null;
+        default_value: string | number | boolean | null;
         in_signup: boolean;
         position: number;
         created_at: string;
     }[];
-};
+}
 interface ContactFieldsCreateParams {
     /**
      * Lowercase letters, digits, `_`. Used as `{{custom.<key>}}`. Immutable.
@@ -1399,18 +2023,18 @@ interface ContactFieldsCreateParams {
      */
     inSignup?: boolean;
 }
-type ContactFieldsCreateResponse = {
-    object: string;
+interface ContactFieldsCreateResponse {
+    object: "contact_field";
     id: string;
     key: string;
     label: string;
-    type: string;
-    options: string[];
-    default_value: unknown;
+    type: "text" | "number" | "date" | "boolean" | "choice";
+    options: string[] | null;
+    default_value: string | number | boolean | null;
     in_signup: boolean;
     position: number;
     created_at: string;
-};
+}
 type ContactFieldsUpdateParams = {
     id: string;
 } & {
@@ -1420,26 +2044,26 @@ type ContactFieldsUpdateParams = {
     inSignup?: boolean;
     position?: number;
 };
-type ContactFieldsUpdateResponse = {
-    object: string;
+interface ContactFieldsUpdateResponse {
+    object: "contact_field";
     id: string;
     key: string;
     label: string;
-    type: string;
-    options: string[];
-    default_value: unknown;
+    type: "text" | "number" | "date" | "boolean" | "choice";
+    options: string[] | null;
+    default_value: string | number | boolean | null;
     in_signup: boolean;
     position: number;
     created_at: string;
-};
+}
 interface ContactFieldsRemoveParams {
     id: string;
 }
-type ContactFieldsRemoveResponse = {
-    object: string;
+interface ContactFieldsRemoveResponse {
+    object: "contact_field";
     id: string;
-    deleted: boolean;
-};
+    deleted: true;
+}
 interface EventsSendParams {
     /**
      * Give `email` or `contact_id`.
@@ -1469,18 +2093,17 @@ interface EventsSendParams {
      */
     segmentId?: string;
 }
-type EventsSendResponse = {
-    object: string;
+interface EventsSendResponse {
+    object: "event";
     id: string;
     email: string;
     event: string;
     properties: {
-        plan: string;
-        amount: number;
+        [k: string]: unknown;
     };
     occurred_at: string;
     contact_created: boolean;
-};
+}
 interface AudienceFiltersListParams {
     /**
      * 1–100, default 20.
@@ -1495,28 +2118,21 @@ interface AudienceFiltersListParams {
      */
     before?: string;
 }
-type AudienceFiltersListResponse = {
-    object: string;
+interface AudienceFiltersListResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "audience_filter";
         id: string;
         name: string;
-        description: unknown;
+        description: string | null;
         rules: {
-            op: string;
-            rules: {
-                field?: string;
-                op: string;
-                value?: string;
-                event?: string;
-                within_days?: number;
-            }[];
+            [k: string]: unknown;
         };
         created_at: string;
         updated_at: string;
     }[];
-};
+}
 interface AudienceFiltersCreateParams {
     name: string;
     description?: string | null;
@@ -1527,45 +2143,31 @@ interface AudienceFiltersCreateParams {
         [k: string]: unknown;
     };
 }
-type AudienceFiltersCreateResponse = {
-    object: string;
+interface AudienceFiltersCreateResponse {
+    object: "audience_filter";
     id: string;
     name: string;
-    description: unknown;
+    description: string | null;
     rules: {
-        op: string;
-        rules: {
-            field?: string;
-            op: string;
-            value?: string;
-            event?: string;
-            within_days?: number;
-        }[];
+        [k: string]: unknown;
     };
     created_at: string;
     updated_at: string;
-};
+}
 interface AudienceFiltersGetParams {
     id: string;
 }
-type AudienceFiltersGetResponse = {
-    object: string;
+interface AudienceFiltersGetResponse {
+    object: "audience_filter";
     id: string;
     name: string;
-    description: unknown;
+    description: string | null;
     rules: {
-        op: string;
-        rules: {
-            field?: string;
-            op: string;
-            value?: string;
-            event?: string;
-            within_days?: number;
-        }[];
+        [k: string]: unknown;
     };
     created_at: string;
     updated_at: string;
-};
+}
 type AudienceFiltersUpdateParams = {
     id: string;
 } & {
@@ -1578,32 +2180,25 @@ type AudienceFiltersUpdateParams = {
         [k: string]: unknown;
     };
 };
-type AudienceFiltersUpdateResponse = {
-    object: string;
+interface AudienceFiltersUpdateResponse {
+    object: "audience_filter";
     id: string;
     name: string;
-    description: unknown;
+    description: string | null;
     rules: {
-        op: string;
-        rules: {
-            field?: string;
-            op: string;
-            value?: string;
-            event?: string;
-            within_days?: number;
-        }[];
+        [k: string]: unknown;
     };
     created_at: string;
     updated_at: string;
-};
+}
 interface AudienceFiltersRemoveParams {
     id: string;
 }
-type AudienceFiltersRemoveResponse = {
-    object: string;
+interface AudienceFiltersRemoveResponse {
+    object: "audience_filter";
     id: string;
-    deleted: boolean;
-};
+    deleted: true;
+}
 interface AudienceFiltersCountParams {
     /**
      * A saved filter. Give `filter_id` or `rules`.
@@ -1620,11 +2215,11 @@ interface AudienceFiltersCountParams {
      */
     segmentId?: string;
 }
-type AudienceFiltersCountResponse = {
-    object: string;
+interface AudienceFiltersCountResponse {
+    object: "audience_filter_count";
     total: number;
     active: number;
-};
+}
 interface SignupsCreateParams {
     email: string;
     name?: string;
@@ -1645,10 +2240,10 @@ interface SignupsCreateParams {
         [k: string]: string | number | boolean | null;
     };
 }
-type SignupsCreateResponse = {
-    object: string;
-    status: string;
-};
+interface SignupsCreateResponse {
+    object: "signup";
+    status: "pending";
+}
 interface SegmentsListParams {
     /**
      * 1–100, default 20.
@@ -1663,16 +2258,19 @@ interface SegmentsListParams {
      */
     before?: string;
 }
-type SegmentsListResponse = {
-    object: string;
+interface SegmentsListResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "segment";
         id: string;
         name: string;
         slug: string;
+        language: string;
+        status: "active" | "archived";
+        created_at: string;
     }[];
-};
+}
 interface SegmentsCreateParams {
     name: string;
     slug: string;
@@ -1680,43 +2278,55 @@ interface SegmentsCreateParams {
     description?: string;
     themes?: string[];
 }
-type SegmentsCreateResponse = {
-    object: string;
+interface SegmentsCreateResponse {
+    object: "segment";
     id: string;
     name: string;
     slug: string;
-};
+    language: string;
+    status: "active" | "archived";
+    created_at: string;
+}
 interface TopicsListParams {
     segmentId: string;
 }
-type TopicsListResponse = {
-    object: string;
+interface TopicsListResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "topic";
         id: string;
         segment_id: string;
         name: string;
+        slug: string;
+        status: "active" | "archived";
+        created_at: string;
     }[];
-};
+}
 interface SegmentsArchiveGetParams {
     id: string;
 }
-type SegmentsArchiveGetResponse = {
-    object: string;
+interface SegmentsArchiveGetResponse {
+    object: "archive";
     segment_id: string;
     enabled: boolean;
     slug: string;
     url: string;
-    custom_domain: string;
-    description: string;
-    author: string;
-    about: unknown;
-    avatar_url: unknown;
+    custom_domain: string | null;
+    description: string | null;
+    author: string | null;
+    about: string | null;
+    avatar_url: string | null;
     links: {
-        x: string;
+        website?: string;
+        x?: string;
+        linkedin?: string;
+        youtube?: string;
+        instagram?: string;
+        github?: string;
+        bluesky?: string;
     };
-};
+}
 type SegmentsArchiveUpdateParams = {
     id: string;
 } & {
@@ -1754,21 +2364,27 @@ type SegmentsArchiveUpdateParams = {
         bluesky?: string | null;
     };
 };
-type SegmentsArchiveUpdateResponse = {
-    object: string;
+interface SegmentsArchiveUpdateResponse {
+    object: "archive";
     segment_id: string;
     enabled: boolean;
     slug: string;
     url: string;
-    custom_domain: string;
-    description: string;
-    author: string;
-    about: unknown;
-    avatar_url: unknown;
+    custom_domain: string | null;
+    description: string | null;
+    author: string | null;
+    about: string | null;
+    avatar_url: string | null;
     links: {
-        x: string;
+        website?: string;
+        x?: string;
+        linkedin?: string;
+        youtube?: string;
+        instagram?: string;
+        github?: string;
+        bluesky?: string;
     };
-};
+}
 type NewslettersArchiveUpdateParams = {
     id: string;
 } & {
@@ -1781,65 +2397,66 @@ type NewslettersArchiveUpdateParams = {
      */
     hidden?: boolean;
 };
-type NewslettersArchiveUpdateResponse = {
-    object: string;
+interface NewslettersArchiveUpdateResponse {
+    object: "newsletter_archive";
     id: string;
     pinned: boolean;
     hidden: boolean;
-};
+}
 interface SegmentsDomainGetParams {
     id: string;
 }
-type SegmentsDomainGetResponse = {
-    object: string;
+interface SegmentsDomainGetResponse {
+    object: "custom_domain";
     id: string;
     segment_id: string;
     domain: string;
-    status: string;
-    uses: string[];
+    status: "pending" | "verified" | "failed";
+    uses: ("tracking" | "preferences" | "archive")[];
     records: {
         type: string;
         name: string;
         value: string;
     }[];
-    last_checked_at: unknown;
-    verified_at: unknown;
-    last_error: unknown;
+    last_checked_at: string | null;
+    verified_at: string | null;
+    last_error: string | null;
     created_at: string;
-};
+}
 type SegmentsDomainSetParams = {
     id: string;
 } & {
     /**
-     * Subdomain you own, e.g. `news.acme.com` (a CNAME to Vercel).
+     * Subdomain you own, e.g. `news.acme.com` (a CNAME to `customers.smartletter.ai`).
      */
     domain: string;
 };
-type SegmentsDomainSetResponse = {
-    object: string;
+interface SegmentsDomainSetResponse {
+    object: "custom_domain";
     id: string;
     segment_id: string;
     domain: string;
-    status: string;
-    uses: string[];
+    status: "pending" | "verified" | "failed";
+    uses: ("tracking" | "preferences" | "archive")[];
     records: {
         type: string;
         name: string;
         value: string;
     }[];
-    last_checked_at: unknown;
-    verified_at: unknown;
-    last_error: unknown;
+    last_checked_at: string | null;
+    verified_at: string | null;
+    last_error: string | null;
     created_at: string;
-};
+}
 interface SegmentsDomainRemoveParams {
     id: string;
 }
-type SegmentsDomainRemoveResponse = {
-    object: string;
+interface SegmentsDomainRemoveResponse {
+    object: "custom_domain";
+    id: string;
     segment_id: string;
-    deleted: boolean;
-};
+    deleted: true;
+}
 interface SuppressionsListParams {
     /**
      * 1–100, default 20.
@@ -1855,36 +2472,41 @@ interface SuppressionsListParams {
     before?: string;
     reason?: "bounced" | "complained" | "user_unsub" | "admin" | "gdpr" | "ses_suppressed" | "soft_bounce_repeated";
 }
-type SuppressionsListResponse = {
-    object: string;
+interface SuppressionsListResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "suppression";
         id: string;
         email: string;
-        reason: string;
-        expires_at: string;
+        reason: "bounced" | "complained" | "user_unsub" | "admin" | "gdpr" | "ses_suppressed" | "soft_bounce_repeated";
+        notes: string | null;
+        created_at: string;
+        expires_at: string | null;
     }[];
-};
+}
 interface SuppressionsCreateParams {
     email: string;
     reason?: "bounced" | "complained" | "user_unsub" | "admin" | "gdpr";
     notes?: string;
 }
-type SuppressionsCreateResponse = {
-    object: string;
+interface SuppressionsCreateResponse {
+    object: "suppression";
     id: string;
     email: string;
-    reason: string;
-};
+    reason: "bounced" | "complained" | "user_unsub" | "admin" | "gdpr" | "ses_suppressed" | "soft_bounce_repeated";
+    notes: string | null;
+    created_at: string;
+    expires_at: string | null;
+}
 interface SuppressionsRemoveParams {
     id: string;
 }
-type SuppressionsRemoveResponse = {
-    object: string;
+interface SuppressionsRemoveResponse {
+    object: "suppression";
     id: string;
-    deleted: boolean;
-};
+    deleted: true;
+}
 interface ImagesListParams {
     /**
      * 1–100, default 20.
@@ -1899,26 +2521,36 @@ interface ImagesListParams {
      */
     before?: string;
 }
-type ImagesListResponse = {
-    object: string;
+interface ImagesListResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "image";
         id: string;
         url: string;
+        content_type: string | null;
+        size_bytes: number | null;
+        width: number | null;
+        height: number | null;
+        kind: "upload" | "generated_image";
+        created_at: string;
     }[];
-};
+}
 type ImagesCreateParams = Blob | ArrayBuffer | Uint8Array | string;
-type ImagesCreateResponse = {
-    object: string;
+interface ImagesCreateResponse {
+    object: "image";
     id: string;
     url: string;
-    content_type: string;
-    size_bytes: number;
-};
+    content_type: string | null;
+    size_bytes: number | null;
+    width: number | null;
+    height: number | null;
+    kind: "upload" | "generated_image";
+    created_at: string;
+}
 type StatsOverviewParams = Record<string, never>;
-type StatsOverviewResponse = {
-    object: string;
+interface StatsOverviewResponse {
+    object: "overview";
     subscribers: {
         active: number;
         new_last_30_days: number;
@@ -1935,29 +2567,30 @@ type StatsOverviewResponse = {
         sent_last_30_days: number;
         newsletters_sent_last_30_days: number;
     };
-};
+}
 interface DomainsCreateParams {
     name: string;
     trackingSubdomain?: string;
 }
-type DomainsCreateResponse = {
-    object: string;
+interface DomainsCreateResponse {
+    object: "domain";
     id: string;
     name: string;
-    status: string;
+    status: "not_started" | "pending" | "verified" | "temporary_failure" | "failed";
+    review_status?: "none" | "pending" | "held" | "approved" | "rejected";
     created_at: string;
     region: string;
     records: {
-        record: string;
+        record: "SPF" | "DKIM" | "MX" | "TXT";
         name: string;
-        type: string;
-        ttl: string;
-        status: string;
+        type: "CNAME" | "MX" | "TXT";
+        ttl: "Auto";
+        status: "verified" | "pending";
         value: string;
         priority?: number;
     }[];
     tracking_subdomain?: string;
-};
+}
 interface DomainsListParams {
     /**
      * 1–100, default 20.
@@ -1972,44 +2605,46 @@ interface DomainsListParams {
      */
     before?: string;
 }
-type DomainsListResponse = {
-    object: string;
+interface DomainsListResponse {
+    object: "list";
     has_more: boolean;
     data: {
         id: string;
         name: string;
-        status: string;
+        status: "not_started" | "pending" | "verified" | "temporary_failure" | "failed";
+        review_status?: "none" | "pending" | "held" | "approved" | "rejected";
         created_at: string;
         region: string;
     }[];
-};
+}
 interface DomainsGetParams {
     id: string;
 }
-type DomainsGetResponse = {
-    object: string;
+interface DomainsGetResponse {
+    object: "domain";
     id: string;
     name: string;
-    status: string;
+    status: "not_started" | "pending" | "verified" | "temporary_failure" | "failed";
+    review_status?: "none" | "pending" | "held" | "approved" | "rejected";
     created_at: string;
     region: string;
     records: {
-        record: string;
+        record: "SPF" | "DKIM" | "MX" | "TXT";
         name: string;
-        type: string;
-        ttl: string;
-        status: string;
+        type: "CNAME" | "MX" | "TXT";
+        ttl: "Auto";
+        status: "verified" | "pending";
         value: string;
         priority?: number;
     }[];
-};
+}
 interface DomainsVerifyParams {
     id: string;
 }
-type DomainsVerifyResponse = {
-    object: string;
+interface DomainsVerifyResponse {
+    object: "domain";
     id: string;
-};
+}
 interface ApiKeysCreateParams {
     name: string;
     permission?: "full_access" | "sending_access" | "signups";
@@ -2018,10 +2653,10 @@ interface ApiKeysCreateParams {
      */
     domainId?: string;
 }
-type ApiKeysCreateResponse = {
+interface ApiKeysCreateResponse {
     id: string;
     token: string;
-};
+}
 interface ApiKeysListParams {
     /**
      * 1–100, default 20.
@@ -2036,8 +2671,8 @@ interface ApiKeysListParams {
      */
     before?: string;
 }
-type ApiKeysListResponse = {
-    object: string;
+interface ApiKeysListResponse {
+    object: "list";
     has_more: boolean;
     data: {
         id: string;
@@ -2045,24 +2680,24 @@ type ApiKeysListResponse = {
         created_at: string;
         last_used_at: string | null;
     }[];
-};
+}
 type ApiKeysUpdateParams = {
     id: string;
 } & {
     name: string;
 };
-type ApiKeysUpdateResponse = {
-    object: string;
+interface ApiKeysUpdateResponse {
+    object: "api_key";
     id: string;
-};
+}
 interface ApiKeysRemoveParams {
     id: string;
 }
-type ApiKeysRemoveResponse = {
-    object: string;
+interface ApiKeysRemoveResponse {
+    object: "api_key";
     id: string;
-    deleted: boolean;
-};
+    deleted: true;
+}
 interface LogsListParams {
     /**
      * 1–100, default 20.
@@ -2077,93 +2712,224 @@ interface LogsListParams {
      */
     before?: string;
 }
-type LogsListResponse = {
-    object: string;
+interface LogsListResponse {
+    object: "list";
     has_more: boolean;
     data: {
         id: string;
+        created_at: string;
         endpoint: string;
         method: string;
         response_status: number;
-        source: string;
+        user_agent: string | null;
+        source: "api" | "smtp";
     }[];
-};
+}
 interface LogsGetParams {
     id: string;
 }
-type LogsGetResponse = {
-    object: string;
+interface LogsGetResponse {
+    object: "log";
     id: string;
+    created_at: string;
     endpoint: string;
-    request_body: Record<string, unknown>;
-    response_body: Record<string, unknown>;
-};
+    method: string;
+    response_status: number;
+    user_agent: string | null;
+    source: "api" | "smtp";
+    request_body: unknown;
+    response_body: unknown;
+    email?: {
+        id: string;
+        last_event: string;
+        created_via: "api" | "mcp" | "smtp" | "inbox";
+        smtp?: {
+            client_ip: string | null;
+            message_id: string | null;
+        };
+        recipients: {
+            email: string;
+            type: "to" | "cc" | "bcc";
+            status: "queued" | "sent" | "delivered" | "delivery_delayed" | "bounced" | "complained" | "failed" | "suppressed" | "canceled";
+            reason: string | null;
+            bounce_type: string | null;
+            smtp_status: string | null;
+            diagnostic_code: string | null;
+            delay_type: string | null;
+            delay_expires_at: string | null;
+            last_event_at: string | null;
+        }[];
+    };
+}
 type UsageGetParams = Record<string, never>;
-type UsageGetResponse = {
-    object: string;
+interface UsageGetResponse {
+    object: "usage";
     emails: {
+        daily: {
+            used: number;
+            limit: number | null;
+            sent: number;
+            received: number;
+            resets_at: string;
+        };
         monthly: {
             used: number;
-            limit: number;
+            limit: number | null;
+            overage_ceiling: number | null;
+            sent: number;
+            received: number;
+            resets_at: string;
         };
     };
     contacts: {
         used: number;
-        limit: unknown;
+        limit: number | null;
     };
-};
+    publications: {
+        used: number;
+        limit: number | null;
+    };
+    domains: {
+        used: number;
+        limit: number | null;
+    };
+    rate_limit: {
+        limit: number;
+        duration: "1000ms";
+    };
+}
 interface SequencesListParams {
     /**
      * Archived sequences are hidden unless `true`.
      */
     includeArchived?: "true" | "false";
 }
-type SequencesListResponse = {
-    object: string;
+interface SequencesListResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "sequence";
         id: string;
         name: string;
-        description: unknown;
-        status: string;
+        description: string | null;
+        status: "draft" | "active" | "paused" | "archived";
         segment_id: string;
-        topic_id: unknown;
+        topic_id: string | null;
         trigger: {
-            type: string;
-            lead_magnet_id: unknown;
+            type: "subscribed";
+            include_imports: boolean;
+        } | {
+            type: "topic_subscribed";
+            topic_id: string;
+        } | {
+            type: "lead_magnet";
+            lead_magnet_id: string | null;
+        } | {
+            type: "event";
+            event: string;
+        } | {
+            type: "email_opened" | "email_clicked";
+            newsletter_id: string | null;
+        } | {
+            type: "filter";
+            filter_id: string;
+            include_existing: boolean;
+        } | {
+            type: "manual";
         };
         reentry: {
-            mode: string;
-            days: unknown;
+            mode: "once" | "always" | "after_days";
+            days: number | null;
         };
         exit: {
             events: string[];
-            filter_id: unknown;
+            filter_id: string | null;
         };
-        steps: {
+        steps: ({
             id: string;
-            type: string;
-            subject?: string;
-            preheader?: unknown;
-            doc?: {
-                type: string;
-                content: unknown[];
+            type: "email";
+            subject: string;
+            preheader: string | null;
+            doc: {
+                [k: string]: unknown;
             };
-            amount?: number;
-            unit?: string;
-        }[];
+        } | {
+            id: string;
+            type: "email";
+            subject: string;
+            preheader: string | null;
+            template_id: string;
+        } | {
+            id: string;
+            type: "delay";
+            amount: number;
+            unit: "minutes" | "hours" | "days";
+        } | {
+            id: string;
+            type: "delay";
+            until: {
+                time: string;
+                weekdays?: number[];
+                timezone: "contact" | "newsletter";
+            };
+        } | {
+            id: string;
+            type: "wait_event";
+            event: string;
+            timeout_hours: number;
+            on_timeout: "continue" | "exit";
+        } | {
+            id: string;
+            type: "condition";
+            filter_id: string;
+            yes: {
+                [k: string]: unknown;
+            }[];
+            no: {
+                [k: string]: unknown;
+            }[];
+        } | {
+            id: string;
+            type: "condition";
+            rule: {
+                [k: string]: unknown;
+            };
+            yes: {
+                [k: string]: unknown;
+            }[];
+            no: {
+                [k: string]: unknown;
+            }[];
+        } | {
+            id: string;
+            type: "update_contact";
+            action: "set_field";
+            key: string;
+            value: string | number | boolean | null;
+        } | {
+            id: string;
+            type: "update_contact";
+            action: "subscribe_topic" | "unsubscribe_topic";
+            topic_id: string;
+        } | {
+            id: string;
+            type: "webhook";
+            webhook_id: string;
+        } | {
+            id: string;
+            type: "exit";
+        })[];
         published_version: {
             id: string;
-            number: number;
-        };
+            number: number | null;
+        } | null;
         has_unpublished_changes: boolean;
-        activated_at: string;
-        archived_at: unknown;
+        activated_at: string | null;
+        archived_at: string | null;
         created_at: string;
         updated_at: string;
     }[];
-};
+}
 interface SequencesCreateParams {
     name: string;
     description?: string | null;
@@ -2323,7 +3089,7 @@ interface SequencesCreateParams {
         /**
          * update_contact set_field: `null` clears it.
          */
-        value?: (string | number | boolean) | null;
+        value?: string | number | boolean | null;
         /**
          * update_contact (un)subscribe_topic.
          */
@@ -2335,90 +3101,253 @@ interface SequencesCreateParams {
         [k: string]: unknown;
     }[];
 }
-type SequencesCreateResponse = {
-    object: string;
+interface SequencesCreateResponse {
+    object: "sequence";
     id: string;
     name: string;
-    description: unknown;
-    status: string;
+    description: string | null;
+    status: "draft" | "active" | "paused" | "archived";
     segment_id: string;
-    topic_id: unknown;
+    topic_id: string | null;
     trigger: {
-        type: string;
-        lead_magnet_id: unknown;
+        type: "subscribed";
+        include_imports: boolean;
+    } | {
+        type: "topic_subscribed";
+        topic_id: string;
+    } | {
+        type: "lead_magnet";
+        lead_magnet_id: string | null;
+    } | {
+        type: "event";
+        event: string;
+    } | {
+        type: "email_opened" | "email_clicked";
+        newsletter_id: string | null;
+    } | {
+        type: "filter";
+        filter_id: string;
+        include_existing: boolean;
+    } | {
+        type: "manual";
     };
     reentry: {
-        mode: string;
-        days: unknown;
+        mode: "once" | "always" | "after_days";
+        days: number | null;
     };
     exit: {
         events: string[];
-        filter_id: unknown;
+        filter_id: string | null;
     };
-    steps: {
+    steps: ({
         id: string;
-        type: string;
-        subject?: string;
-        preheader?: unknown;
-        doc?: {
-            type: string;
-            content: unknown[];
+        type: "email";
+        subject: string;
+        preheader: string | null;
+        doc: {
+            [k: string]: unknown;
         };
-        amount?: number;
-        unit?: string;
-    }[];
-    published_version: unknown;
+    } | {
+        id: string;
+        type: "email";
+        subject: string;
+        preheader: string | null;
+        template_id: string;
+    } | {
+        id: string;
+        type: "delay";
+        amount: number;
+        unit: "minutes" | "hours" | "days";
+    } | {
+        id: string;
+        type: "delay";
+        until: {
+            time: string;
+            weekdays?: number[];
+            timezone: "contact" | "newsletter";
+        };
+    } | {
+        id: string;
+        type: "wait_event";
+        event: string;
+        timeout_hours: number;
+        on_timeout: "continue" | "exit";
+    } | {
+        id: string;
+        type: "condition";
+        filter_id: string;
+        yes: {
+            [k: string]: unknown;
+        }[];
+        no: {
+            [k: string]: unknown;
+        }[];
+    } | {
+        id: string;
+        type: "condition";
+        rule: {
+            [k: string]: unknown;
+        };
+        yes: {
+            [k: string]: unknown;
+        }[];
+        no: {
+            [k: string]: unknown;
+        }[];
+    } | {
+        id: string;
+        type: "update_contact";
+        action: "set_field";
+        key: string;
+        value: string | number | boolean | null;
+    } | {
+        id: string;
+        type: "update_contact";
+        action: "subscribe_topic" | "unsubscribe_topic";
+        topic_id: string;
+    } | {
+        id: string;
+        type: "webhook";
+        webhook_id: string;
+    } | {
+        id: string;
+        type: "exit";
+    })[];
+    published_version: {
+        id: string;
+        number: number | null;
+    } | null;
     has_unpublished_changes: boolean;
-    activated_at: string;
-    archived_at: unknown;
+    activated_at: string | null;
+    archived_at: string | null;
     created_at: string;
     updated_at: string;
-};
+}
 interface SequencesGetParams {
     id: string;
 }
-type SequencesGetResponse = {
-    object: string;
+interface SequencesGetResponse {
+    object: "sequence";
     id: string;
     name: string;
-    description: unknown;
-    status: string;
+    description: string | null;
+    status: "draft" | "active" | "paused" | "archived";
     segment_id: string;
-    topic_id: unknown;
+    topic_id: string | null;
     trigger: {
-        type: string;
-        lead_magnet_id: unknown;
+        type: "subscribed";
+        include_imports: boolean;
+    } | {
+        type: "topic_subscribed";
+        topic_id: string;
+    } | {
+        type: "lead_magnet";
+        lead_magnet_id: string | null;
+    } | {
+        type: "event";
+        event: string;
+    } | {
+        type: "email_opened" | "email_clicked";
+        newsletter_id: string | null;
+    } | {
+        type: "filter";
+        filter_id: string;
+        include_existing: boolean;
+    } | {
+        type: "manual";
     };
     reentry: {
-        mode: string;
-        days: unknown;
+        mode: "once" | "always" | "after_days";
+        days: number | null;
     };
     exit: {
         events: string[];
-        filter_id: unknown;
+        filter_id: string | null;
     };
-    steps: {
+    steps: ({
+        id: string;
+        type: "email";
+        subject: string;
+        preheader: string | null;
+        doc: {
+            [k: string]: unknown;
+        };
+    } | {
+        id: string;
+        type: "email";
+        subject: string;
+        preheader: string | null;
+        template_id: string;
+    } | {
+        id: string;
+        type: "delay";
+        amount: number;
+        unit: "minutes" | "hours" | "days";
+    } | {
+        id: string;
+        type: "delay";
+        until: {
+            time: string;
+            weekdays?: number[];
+            timezone: "contact" | "newsletter";
+        };
+    } | {
+        id: string;
+        type: "wait_event";
+        event: string;
+        timeout_hours: number;
+        on_timeout: "continue" | "exit";
+    } | {
         id: string;
-        type: string;
-        subject?: string;
-        preheader?: unknown;
-        doc?: {
-            type: string;
-            content: unknown[];
+        type: "condition";
+        filter_id: string;
+        yes: {
+            [k: string]: unknown;
+        }[];
+        no: {
+            [k: string]: unknown;
+        }[];
+    } | {
+        id: string;
+        type: "condition";
+        rule: {
+            [k: string]: unknown;
         };
-        amount?: number;
-        unit?: string;
-    }[];
+        yes: {
+            [k: string]: unknown;
+        }[];
+        no: {
+            [k: string]: unknown;
+        }[];
+    } | {
+        id: string;
+        type: "update_contact";
+        action: "set_field";
+        key: string;
+        value: string | number | boolean | null;
+    } | {
+        id: string;
+        type: "update_contact";
+        action: "subscribe_topic" | "unsubscribe_topic";
+        topic_id: string;
+    } | {
+        id: string;
+        type: "webhook";
+        webhook_id: string;
+    } | {
+        id: string;
+        type: "exit";
+    })[];
     published_version: {
         id: string;
-        number: number;
-    };
+        number: number | null;
+    } | null;
     has_unpublished_changes: boolean;
-    activated_at: string;
-    archived_at: unknown;
+    activated_at: string | null;
+    archived_at: string | null;
     created_at: string;
     updated_at: string;
-};
+}
 type SequencesUpdateParams = {
     id: string;
 } & {
@@ -2580,7 +3509,7 @@ type SequencesUpdateParams = {
         /**
          * update_contact set_field: `null` clears it.
          */
-        value?: (string | number | boolean) | null;
+        value?: string | number | boolean | null;
         /**
          * update_contact (un)subscribe_topic.
          */
@@ -2592,219 +3521,552 @@ type SequencesUpdateParams = {
         [k: string]: unknown;
     }[];
 };
-type SequencesUpdateResponse = {
-    object: string;
+interface SequencesUpdateResponse {
+    object: "sequence";
     id: string;
     name: string;
-    description: unknown;
-    status: string;
+    description: string | null;
+    status: "draft" | "active" | "paused" | "archived";
     segment_id: string;
-    topic_id: unknown;
+    topic_id: string | null;
     trigger: {
-        type: string;
-        lead_magnet_id: unknown;
+        type: "subscribed";
+        include_imports: boolean;
+    } | {
+        type: "topic_subscribed";
+        topic_id: string;
+    } | {
+        type: "lead_magnet";
+        lead_magnet_id: string | null;
+    } | {
+        type: "event";
+        event: string;
+    } | {
+        type: "email_opened" | "email_clicked";
+        newsletter_id: string | null;
+    } | {
+        type: "filter";
+        filter_id: string;
+        include_existing: boolean;
+    } | {
+        type: "manual";
     };
     reentry: {
-        mode: string;
-        days: unknown;
+        mode: "once" | "always" | "after_days";
+        days: number | null;
     };
     exit: {
         events: string[];
-        filter_id: unknown;
+        filter_id: string | null;
     };
-    steps: {
+    steps: ({
         id: string;
-        type: string;
-        subject?: string;
-        preheader?: unknown;
-        doc?: {
-            type: string;
-            content: unknown[];
+        type: "email";
+        subject: string;
+        preheader: string | null;
+        doc: {
+            [k: string]: unknown;
         };
-        amount?: number;
-        unit?: string;
-    }[];
+    } | {
+        id: string;
+        type: "email";
+        subject: string;
+        preheader: string | null;
+        template_id: string;
+    } | {
+        id: string;
+        type: "delay";
+        amount: number;
+        unit: "minutes" | "hours" | "days";
+    } | {
+        id: string;
+        type: "delay";
+        until: {
+            time: string;
+            weekdays?: number[];
+            timezone: "contact" | "newsletter";
+        };
+    } | {
+        id: string;
+        type: "wait_event";
+        event: string;
+        timeout_hours: number;
+        on_timeout: "continue" | "exit";
+    } | {
+        id: string;
+        type: "condition";
+        filter_id: string;
+        yes: {
+            [k: string]: unknown;
+        }[];
+        no: {
+            [k: string]: unknown;
+        }[];
+    } | {
+        id: string;
+        type: "condition";
+        rule: {
+            [k: string]: unknown;
+        };
+        yes: {
+            [k: string]: unknown;
+        }[];
+        no: {
+            [k: string]: unknown;
+        }[];
+    } | {
+        id: string;
+        type: "update_contact";
+        action: "set_field";
+        key: string;
+        value: string | number | boolean | null;
+    } | {
+        id: string;
+        type: "update_contact";
+        action: "subscribe_topic" | "unsubscribe_topic";
+        topic_id: string;
+    } | {
+        id: string;
+        type: "webhook";
+        webhook_id: string;
+    } | {
+        id: string;
+        type: "exit";
+    })[];
     published_version: {
         id: string;
-        number: number;
-    };
+        number: number | null;
+    } | null;
     has_unpublished_changes: boolean;
-    activated_at: string;
-    archived_at: unknown;
+    activated_at: string | null;
+    archived_at: string | null;
     created_at: string;
     updated_at: string;
-};
+}
 interface SequencesRemoveParams {
     id: string;
 }
 type SequencesRemoveResponse = {
-    object: string;
+    object: "sequence";
     id: string;
-    deleted: boolean;
+    deleted: true;
+} | {
+    object: "sequence";
+    id: string;
+    deleted: false;
+    archived: true;
 };
 interface SequencesActivateParams {
     id: string;
 }
-type SequencesActivateResponse = {
-    object: string;
+interface SequencesActivateResponse {
+    object: "sequence";
     id: string;
     name: string;
-    description: unknown;
-    status: string;
+    description: string | null;
+    status: "draft" | "active" | "paused" | "archived";
     segment_id: string;
-    topic_id: unknown;
+    topic_id: string | null;
     trigger: {
-        type: string;
-        lead_magnet_id: unknown;
+        type: "subscribed";
+        include_imports: boolean;
+    } | {
+        type: "topic_subscribed";
+        topic_id: string;
+    } | {
+        type: "lead_magnet";
+        lead_magnet_id: string | null;
+    } | {
+        type: "event";
+        event: string;
+    } | {
+        type: "email_opened" | "email_clicked";
+        newsletter_id: string | null;
+    } | {
+        type: "filter";
+        filter_id: string;
+        include_existing: boolean;
+    } | {
+        type: "manual";
     };
     reentry: {
-        mode: string;
-        days: unknown;
+        mode: "once" | "always" | "after_days";
+        days: number | null;
     };
     exit: {
         events: string[];
-        filter_id: unknown;
+        filter_id: string | null;
     };
-    steps: {
+    steps: ({
         id: string;
-        type: string;
-        subject?: string;
-        preheader?: unknown;
-        doc?: {
-            type: string;
-            content: unknown[];
+        type: "email";
+        subject: string;
+        preheader: string | null;
+        doc: {
+            [k: string]: unknown;
         };
-        amount?: number;
-        unit?: string;
-    }[];
+    } | {
+        id: string;
+        type: "email";
+        subject: string;
+        preheader: string | null;
+        template_id: string;
+    } | {
+        id: string;
+        type: "delay";
+        amount: number;
+        unit: "minutes" | "hours" | "days";
+    } | {
+        id: string;
+        type: "delay";
+        until: {
+            time: string;
+            weekdays?: number[];
+            timezone: "contact" | "newsletter";
+        };
+    } | {
+        id: string;
+        type: "wait_event";
+        event: string;
+        timeout_hours: number;
+        on_timeout: "continue" | "exit";
+    } | {
+        id: string;
+        type: "condition";
+        filter_id: string;
+        yes: {
+            [k: string]: unknown;
+        }[];
+        no: {
+            [k: string]: unknown;
+        }[];
+    } | {
+        id: string;
+        type: "condition";
+        rule: {
+            [k: string]: unknown;
+        };
+        yes: {
+            [k: string]: unknown;
+        }[];
+        no: {
+            [k: string]: unknown;
+        }[];
+    } | {
+        id: string;
+        type: "update_contact";
+        action: "set_field";
+        key: string;
+        value: string | number | boolean | null;
+    } | {
+        id: string;
+        type: "update_contact";
+        action: "subscribe_topic" | "unsubscribe_topic";
+        topic_id: string;
+    } | {
+        id: string;
+        type: "webhook";
+        webhook_id: string;
+    } | {
+        id: string;
+        type: "exit";
+    })[];
     published_version: {
         id: string;
-        number: number;
-    };
+        number: number | null;
+    } | null;
     has_unpublished_changes: boolean;
-    activated_at: string;
-    archived_at: unknown;
+    activated_at: string | null;
+    archived_at: string | null;
     created_at: string;
     updated_at: string;
-};
+}
 interface SequencesPauseParams {
     id: string;
 }
-type SequencesPauseResponse = {
-    object: string;
+interface SequencesPauseResponse {
+    object: "sequence";
     id: string;
     name: string;
-    description: unknown;
-    status: string;
+    description: string | null;
+    status: "draft" | "active" | "paused" | "archived";
     segment_id: string;
-    topic_id: unknown;
+    topic_id: string | null;
     trigger: {
-        type: string;
-        lead_magnet_id: unknown;
+        type: "subscribed";
+        include_imports: boolean;
+    } | {
+        type: "topic_subscribed";
+        topic_id: string;
+    } | {
+        type: "lead_magnet";
+        lead_magnet_id: string | null;
+    } | {
+        type: "event";
+        event: string;
+    } | {
+        type: "email_opened" | "email_clicked";
+        newsletter_id: string | null;
+    } | {
+        type: "filter";
+        filter_id: string;
+        include_existing: boolean;
+    } | {
+        type: "manual";
     };
     reentry: {
-        mode: string;
-        days: unknown;
+        mode: "once" | "always" | "after_days";
+        days: number | null;
     };
     exit: {
         events: string[];
-        filter_id: unknown;
+        filter_id: string | null;
     };
-    steps: {
+    steps: ({
         id: string;
-        type: string;
-        subject?: string;
-        preheader?: unknown;
-        doc?: {
-            type: string;
-            content: unknown[];
+        type: "email";
+        subject: string;
+        preheader: string | null;
+        doc: {
+            [k: string]: unknown;
         };
-        amount?: number;
-        unit?: string;
-    }[];
+    } | {
+        id: string;
+        type: "email";
+        subject: string;
+        preheader: string | null;
+        template_id: string;
+    } | {
+        id: string;
+        type: "delay";
+        amount: number;
+        unit: "minutes" | "hours" | "days";
+    } | {
+        id: string;
+        type: "delay";
+        until: {
+            time: string;
+            weekdays?: number[];
+            timezone: "contact" | "newsletter";
+        };
+    } | {
+        id: string;
+        type: "wait_event";
+        event: string;
+        timeout_hours: number;
+        on_timeout: "continue" | "exit";
+    } | {
+        id: string;
+        type: "condition";
+        filter_id: string;
+        yes: {
+            [k: string]: unknown;
+        }[];
+        no: {
+            [k: string]: unknown;
+        }[];
+    } | {
+        id: string;
+        type: "condition";
+        rule: {
+            [k: string]: unknown;
+        };
+        yes: {
+            [k: string]: unknown;
+        }[];
+        no: {
+            [k: string]: unknown;
+        }[];
+    } | {
+        id: string;
+        type: "update_contact";
+        action: "set_field";
+        key: string;
+        value: string | number | boolean | null;
+    } | {
+        id: string;
+        type: "update_contact";
+        action: "subscribe_topic" | "unsubscribe_topic";
+        topic_id: string;
+    } | {
+        id: string;
+        type: "webhook";
+        webhook_id: string;
+    } | {
+        id: string;
+        type: "exit";
+    })[];
     published_version: {
         id: string;
-        number: number;
-    };
+        number: number | null;
+    } | null;
     has_unpublished_changes: boolean;
-    activated_at: string;
-    archived_at: unknown;
+    activated_at: string | null;
+    archived_at: string | null;
     created_at: string;
     updated_at: string;
-};
+}
 interface SequencesArchiveParams {
     id: string;
 }
-type SequencesArchiveResponse = {
-    object: string;
+interface SequencesArchiveResponse {
+    object: "sequence";
     id: string;
     name: string;
-    description: unknown;
-    status: string;
+    description: string | null;
+    status: "draft" | "active" | "paused" | "archived";
     segment_id: string;
-    topic_id: unknown;
+    topic_id: string | null;
     trigger: {
-        type: string;
-        lead_magnet_id: unknown;
+        type: "subscribed";
+        include_imports: boolean;
+    } | {
+        type: "topic_subscribed";
+        topic_id: string;
+    } | {
+        type: "lead_magnet";
+        lead_magnet_id: string | null;
+    } | {
+        type: "event";
+        event: string;
+    } | {
+        type: "email_opened" | "email_clicked";
+        newsletter_id: string | null;
+    } | {
+        type: "filter";
+        filter_id: string;
+        include_existing: boolean;
+    } | {
+        type: "manual";
     };
     reentry: {
-        mode: string;
-        days: unknown;
+        mode: "once" | "always" | "after_days";
+        days: number | null;
     };
     exit: {
         events: string[];
-        filter_id: unknown;
+        filter_id: string | null;
     };
-    steps: {
+    steps: ({
+        id: string;
+        type: "email";
+        subject: string;
+        preheader: string | null;
+        doc: {
+            [k: string]: unknown;
+        };
+    } | {
+        id: string;
+        type: "email";
+        subject: string;
+        preheader: string | null;
+        template_id: string;
+    } | {
+        id: string;
+        type: "delay";
+        amount: number;
+        unit: "minutes" | "hours" | "days";
+    } | {
+        id: string;
+        type: "delay";
+        until: {
+            time: string;
+            weekdays?: number[];
+            timezone: "contact" | "newsletter";
+        };
+    } | {
+        id: string;
+        type: "wait_event";
+        event: string;
+        timeout_hours: number;
+        on_timeout: "continue" | "exit";
+    } | {
+        id: string;
+        type: "condition";
+        filter_id: string;
+        yes: {
+            [k: string]: unknown;
+        }[];
+        no: {
+            [k: string]: unknown;
+        }[];
+    } | {
         id: string;
-        type: string;
-        subject?: string;
-        preheader?: unknown;
-        doc?: {
-            type: string;
-            content: unknown[];
+        type: "condition";
+        rule: {
+            [k: string]: unknown;
         };
-        amount?: number;
-        unit?: string;
-    }[];
+        yes: {
+            [k: string]: unknown;
+        }[];
+        no: {
+            [k: string]: unknown;
+        }[];
+    } | {
+        id: string;
+        type: "update_contact";
+        action: "set_field";
+        key: string;
+        value: string | number | boolean | null;
+    } | {
+        id: string;
+        type: "update_contact";
+        action: "subscribe_topic" | "unsubscribe_topic";
+        topic_id: string;
+    } | {
+        id: string;
+        type: "webhook";
+        webhook_id: string;
+    } | {
+        id: string;
+        type: "exit";
+    })[];
     published_version: {
         id: string;
-        number: number;
-    };
+        number: number | null;
+    } | null;
     has_unpublished_changes: boolean;
-    activated_at: string;
-    archived_at: string;
+    activated_at: string | null;
+    archived_at: string | null;
     created_at: string;
     updated_at: string;
-};
+}
 type SequencesEnrollmentsParams = {
     id: string;
 } & {
-    status?: "active" | "completed" | "exited";
     /**
-     * Newest first, 1–100 (default 100).
+     * 1–100, default 100.
      */
     limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+    status?: "active" | "completed" | "exited";
 };
-type SequencesEnrollmentsResponse = {
-    object: string;
+interface SequencesEnrollmentsResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "sequence_enrollment";
         id: string;
         sequence_id: string;
-        contact_id: string;
+        contact_id: string | null;
         email: string;
-        status: string;
-        exit_reason: unknown;
-        current_step_id: string;
-        next_run_at: string;
-        source: string;
+        status: "active" | "completed" | "exited";
+        exit_reason: string | null;
+        current_step_id: string | null;
+        next_run_at: string | null;
+        source: "trigger" | "filter" | "manual" | "api" | "mcp";
         entered_at: string;
-        completed_at: unknown;
-        exited_at: unknown;
+        completed_at: string | null;
+        exited_at: string | null;
     }[];
-};
+}
 type SequencesEnrollParams = {
     id: string;
 } & {
@@ -2814,28 +4076,28 @@ type SequencesEnrollParams = {
     email?: string;
     contactId?: string;
 };
-type SequencesEnrollResponse = {
-    object: string;
+interface SequencesEnrollResponse {
+    object: "sequence_enrollment";
     id: string;
     sequence_id: string;
     contact_id: string;
-    status: string;
-};
+    status: "active";
+}
 interface SequencesUnenrollParams {
     id: string;
     enrollmentId: string;
 }
-type SequencesUnenrollResponse = {
-    object: string;
+interface SequencesUnenrollResponse {
+    object: "sequence_enrollment";
     id: string;
     sequence_id: string;
-    status: string;
-};
+    status: "completed" | "exited";
+}
 interface SequencesStatsParams {
     id: string;
 }
-type SequencesStatsResponse = {
-    object: string;
+interface SequencesStatsResponse {
+    object: "sequence_stats";
     sequence_id: string;
     entered: number;
     active: number;
@@ -2851,7 +4113,7 @@ type SequencesStatsResponse = {
         bounced: number;
         unsubscribed: number;
     }[];
-};
+}
 interface WebhooksCreateParams {
     /**
      * Public `https://` URL that receives the events.
@@ -2875,11 +4137,11 @@ interface WebhooksCreateParams {
      */
     domains?: string[];
 }
-type WebhooksCreateResponse = {
-    object: string;
+interface WebhooksCreateResponse {
+    object: "webhook";
     id: string;
     signing_secret: string;
-};
+}
 interface WebhooksListParams {
     /**
      * 1–100, default 20.
@@ -2894,45 +4156,45 @@ interface WebhooksListParams {
      */
     before?: string;
 }
-type WebhooksListResponse = {
-    object: string;
+interface WebhooksListResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "webhook";
         id: string;
         endpoint: string;
-        description: string;
-        events: string[];
+        description: string | null;
+        events: ("email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | "email.opened" | "email.clicked" | "email.failed" | "email.scheduled" | "contact.created" | "contact.updated" | "contact.deleted" | "domain.created" | "domain.updated" | "domain.deleted" | "sequence.entered" | "sequence.completed" | "sequence.exited" | "inbound.received")[];
         include_newsletters: boolean;
-        segment_ids: unknown[];
-        domains: unknown[];
-        status: string;
-        disabled_reason: unknown;
+        segment_ids: string[];
+        domains: string[];
+        status: "enabled" | "disabled";
+        disabled_reason: ("manual" | "failing") | null;
         consecutive_failures: number;
-        last_success_at: string;
-        last_failure_at: unknown;
+        last_success_at: string | null;
+        last_failure_at: string | null;
         created_at: string;
     }[];
-};
+}
 interface WebhooksGetParams {
     id: string;
 }
-type WebhooksGetResponse = {
-    object: string;
+interface WebhooksGetResponse {
+    object: "webhook";
     id: string;
     endpoint: string;
-    description: string;
-    events: string[];
+    description: string | null;
+    events: ("email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | "email.opened" | "email.clicked" | "email.failed" | "email.scheduled" | "contact.created" | "contact.updated" | "contact.deleted" | "domain.created" | "domain.updated" | "domain.deleted" | "sequence.entered" | "sequence.completed" | "sequence.exited" | "inbound.received")[];
     include_newsletters: boolean;
-    segment_ids: unknown[];
-    domains: unknown[];
-    status: string;
-    disabled_reason: unknown;
+    segment_ids: string[];
+    domains: string[];
+    status: "enabled" | "disabled";
+    disabled_reason: ("manual" | "failing") | null;
     consecutive_failures: number;
-    last_success_at: string;
-    last_failure_at: unknown;
+    last_success_at: string | null;
+    last_failure_at: string | null;
     created_at: string;
-};
+}
 type WebhooksUpdateParams = {
     id: string;
 } & {
@@ -2959,27 +4221,27 @@ type WebhooksUpdateParams = {
      */
     domains?: string[];
 };
-type WebhooksUpdateResponse = {
-    object: string;
+interface WebhooksUpdateResponse {
+    object: "webhook";
     id: string;
-};
+}
 interface WebhooksRemoveParams {
     id: string;
 }
-type WebhooksRemoveResponse = {
-    object: string;
+interface WebhooksRemoveResponse {
+    object: "webhook";
     id: string;
-    deleted: boolean;
-};
+    deleted: true;
+}
 interface WebhooksRotateSigningSecretParams {
     id: string;
 }
-type WebhooksRotateSigningSecretResponse = {
-    object: string;
+interface WebhooksRotateSigningSecretResponse {
+    object: "webhook";
     id: string;
     signing_secret: string;
     previous_secret_expires_at: string;
-};
+}
 type WebhooksTestParams = {
     id: string;
 } & {
@@ -2988,29 +4250,29 @@ type WebhooksTestParams = {
      */
     type?: "email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | "email.opened" | "email.clicked" | "email.failed" | "email.scheduled" | "contact.created" | "contact.updated" | "contact.deleted" | "domain.created" | "domain.updated" | "domain.deleted" | "sequence.entered" | "sequence.completed" | "sequence.exited" | "inbound.received";
 };
-type WebhooksTestResponse = {
-    object: string;
+interface WebhooksTestResponse {
+    object: "webhook_delivery";
     id: string;
     msg_id: string;
     webhook_id: string;
     event_type: string;
-    status: string;
+    status: "pending" | "processing" | "delivered" | "failed";
     attempts: number;
-    next_attempt_at: unknown;
-    last_status_code: number;
-    last_response: string;
-    last_error: unknown;
-    last_duration_ms: number;
+    next_attempt_at: string | null;
+    last_status_code: number | null;
+    last_response: string | null;
+    last_error: string | null;
+    last_duration_ms: number | null;
     payload: {
         type: string;
         created_at: string;
         data: {
-            email_id: string;
+            [k: string]: unknown;
         };
     };
-    delivered_at: string;
+    delivered_at: string | null;
     created_at: string;
-};
+}
 type WebhooksDeliveriesParams = {
     id: string;
 } & {
@@ -3028,81 +4290,81 @@ type WebhooksDeliveriesParams = {
     before?: string;
     status?: "pending" | "processing" | "delivered" | "failed";
 };
-type WebhooksDeliveriesResponse = {
-    object: string;
+interface WebhooksDeliveriesResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "webhook_delivery";
         id: string;
         msg_id: string;
         webhook_id: string;
         event_type: string;
-        status: string;
+        status: "pending" | "processing" | "delivered" | "failed";
         attempts: number;
-        next_attempt_at: unknown;
-        last_status_code: number;
-        last_response: string;
-        last_error: unknown;
-        last_duration_ms: number;
+        next_attempt_at: string | null;
+        last_status_code: number | null;
+        last_response: string | null;
+        last_error: string | null;
+        last_duration_ms: number | null;
         payload: {
             type: string;
             created_at: string;
             data: {
-                email_id: string;
+                [k: string]: unknown;
             };
         };
-        delivered_at: string;
+        delivered_at: string | null;
         created_at: string;
     }[];
-};
+}
 interface WebhooksRetryDeliveryParams {
     id: string;
     deliveryId: string;
 }
-type WebhooksRetryDeliveryResponse = {
-    object: string;
+interface WebhooksRetryDeliveryResponse {
+    object: "webhook_delivery";
     id: string;
     msg_id: string;
     webhook_id: string;
     event_type: string;
-    status: string;
+    status: "pending" | "processing" | "delivered" | "failed";
     attempts: number;
-    next_attempt_at: unknown;
-    last_status_code: number;
-    last_response: string;
-    last_error: unknown;
-    last_duration_ms: number;
+    next_attempt_at: string | null;
+    last_status_code: number | null;
+    last_response: string | null;
+    last_error: string | null;
+    last_duration_ms: number | null;
     payload: {
         type: string;
         created_at: string;
         data: {
-            email_id: string;
+            [k: string]: unknown;
         };
     };
-    delivered_at: string;
+    delivered_at: string | null;
     created_at: string;
-};
+}
 type InboxesListParams = Record<string, never>;
-type InboxesListResponse = {
-    object: string;
+interface InboxesListResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "inbox";
         id: string;
         address: string;
         name: string;
-        display_name: string;
-        description: string;
-        reply_from: unknown;
-        status: string;
+        display_name: string | null;
+        description: string | null;
+        reply_from: string | null;
+        status: "active" | "disabled";
         custom_domain: boolean;
-        domain_id: unknown;
+        domain_id: string | null;
         dropped_count: number;
-        last_dropped_at: unknown;
+        last_dropped_at: string | null;
         created_at: string;
         updated_at: string;
     }[];
-};
+}
 interface InboxesCreateParams {
     /**
      * Local part: `support` gives `support-<workspace>@in.smartletter.ai` (or `support@<your receiving domain>` with `domain_id`).
@@ -3125,41 +4387,41 @@ interface InboxesCreateParams {
      */
     replyFrom?: string | null;
 }
-type InboxesCreateResponse = {
-    object: string;
+interface InboxesCreateResponse {
+    object: "inbox";
     id: string;
     address: string;
     name: string;
-    display_name: string;
-    description: string;
-    reply_from: unknown;
-    status: string;
+    display_name: string | null;
+    description: string | null;
+    reply_from: string | null;
+    status: "active" | "disabled";
     custom_domain: boolean;
-    domain_id: unknown;
+    domain_id: string | null;
     dropped_count: number;
-    last_dropped_at: unknown;
+    last_dropped_at: string | null;
     created_at: string;
     updated_at: string;
-};
+}
 interface InboxesGetParams {
     id: string;
 }
-type InboxesGetResponse = {
-    object: string;
+interface InboxesGetResponse {
+    object: "inbox";
     id: string;
     address: string;
     name: string;
-    display_name: string;
-    description: string;
-    reply_from: unknown;
-    status: string;
+    display_name: string | null;
+    description: string | null;
+    reply_from: string | null;
+    status: "active" | "disabled";
     custom_domain: boolean;
-    domain_id: unknown;
+    domain_id: string | null;
     dropped_count: number;
-    last_dropped_at: unknown;
+    last_dropped_at: string | null;
     created_at: string;
     updated_at: string;
-};
+}
 type InboxesUpdateParams = {
     id: string;
 } & {
@@ -3180,31 +4442,43 @@ type InboxesUpdateParams = {
      */
     status?: "active" | "disabled";
 };
-type InboxesUpdateResponse = {
-    object: string;
+interface InboxesUpdateResponse {
+    object: "inbox";
     id: string;
     address: string;
     name: string;
-    display_name: string;
-    description: string;
-    reply_from: unknown;
-    status: string;
+    display_name: string | null;
+    description: string | null;
+    reply_from: string | null;
+    status: "active" | "disabled";
     custom_domain: boolean;
-    domain_id: unknown;
+    domain_id: string | null;
     dropped_count: number;
-    last_dropped_at: unknown;
+    last_dropped_at: string | null;
     created_at: string;
     updated_at: string;
-};
+}
 interface InboxesRemoveParams {
     id: string;
 }
-type InboxesRemoveResponse = {
-    object: string;
+interface InboxesRemoveResponse {
+    object: "inbox";
     id: string;
-    deleted: boolean;
-};
+    deleted: true;
+}
 interface ThreadsListParams {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
     inboxId?: string;
     /**
      * Default: every status but `archived`.
@@ -3217,111 +4491,139 @@ interface ThreadsListParams {
     spam?: "exclude" | "only" | "include";
     assigneeAgent?: string;
     unread?: "true" | "false";
-    /**
-     * 1–100, default 20.
-     */
-    limit?: number;
-    /**
-     * Id of the last thread of the previous page.
-     */
-    after?: string;
 }
-type ThreadsListResponse = {
-    object: string;
+interface ThreadsListResponse {
+    object: "list";
     has_more: boolean;
     data: {
-        object: string;
+        object: "inbox_thread";
         id: string;
         inbox_id: string;
-        subject: string;
-        status: string;
+        subject: string | null;
+        status: "open" | "pending" | "done" | "archived";
         spam: boolean;
-        labels: unknown[];
-        assignee_user_id: unknown;
-        assignee_agent: unknown;
+        labels: string[];
+        assignee_user_id: string | null;
+        assignee_agent: string | null;
         message_count: number;
         unread: boolean;
         participants: string[];
         last_message_at: string;
-        last_inbound_at: string;
+        last_inbound_at: string | null;
         created_at: string;
         updated_at: string;
         last_message: {
             id: string;
-            direction: string;
+            direction: "inbound" | "outbound";
             from: string;
-            snippet: string;
+            snippet: string | null;
             received_at: string;
-        };
+        } | null;
     }[];
-};
+}
 interface ThreadsGetParams {
     id: string;
 }
-type ThreadsGetResponse = {
-    object: string;
+interface ThreadsGetResponse {
+    object: "inbox_thread";
     id: string;
     inbox_id: string;
-    subject: string;
-    status: string;
+    subject: string | null;
+    status: "open" | "pending" | "done" | "archived";
     spam: boolean;
-    labels: unknown[];
-    assignee_user_id: unknown;
-    assignee_agent: unknown;
+    labels: string[];
+    assignee_user_id: string | null;
+    assignee_agent: string | null;
     message_count: number;
     unread: boolean;
     participants: string[];
     last_message_at: string;
-    last_inbound_at: string;
+    last_inbound_at: string | null;
     created_at: string;
     updated_at: string;
-    messages: {
-        object: string;
+    messages: ({
+        object: "inbox_message";
         id: string;
-        thread_id: string;
+        thread_id: string | null;
         inbox_id: string;
-        direction: string;
-        status: string;
         from: string;
         from_address: string;
-        from_name: string;
+        from_name: string | null;
         to: string[];
-        cc: unknown[];
-        reply_to: unknown[];
-        subject: string;
-        text: string;
-        html: string;
-        snippet: string;
+        cc: string[];
+        reply_to: string[];
+        subject: string | null;
+        text: string | null;
+        html: string | null;
+        snippet: string | null;
         remote_images: number;
         body_truncated: boolean;
-        message_id: string;
-        in_reply_to: unknown;
-        references: unknown[];
+        message_id: string | null;
+        in_reply_to: string | null;
+        references: string[];
+        attachments: {
+            id: string;
+            filename: string;
+            content_type: string;
+            size: number;
+            inline: boolean;
+            content_id: string | null;
+            available: boolean;
+            expires_at: string;
+        }[];
+        received_at: string;
+        created_at: string;
+        direction: "inbound";
+        status: "inbox" | "spam";
         spam: {
-            score: number;
-            verdict: string;
-            virus: string;
-            spf: string;
-            dkim: string;
-            dmarc: string;
-            reasons: unknown[];
+            score: number | null;
+            verdict: string | null;
+            virus: string | null;
+            spf: string | null;
+            dkim: string | null;
+            dmarc: string | null;
+            reasons: string[];
         };
         auto_submitted: boolean;
-        automation_reason: unknown;
+        automation_reason: string | null;
+    } | {
+        object: "inbox_message";
+        id: string;
+        thread_id: string | null;
+        inbox_id: string;
+        from: string;
+        from_address: string;
+        from_name: string | null;
+        to: string[];
+        cc: string[];
+        reply_to: string[];
+        subject: string | null;
+        text: string | null;
+        html: string | null;
+        snippet: string | null;
+        remote_images: number;
+        body_truncated: boolean;
+        message_id: string | null;
+        in_reply_to: string | null;
+        references: string[];
         attachments: {
             id: string;
             filename: string;
             content_type: string;
             size: number;
             inline: boolean;
-            content_id: unknown;
+            content_id: string | null;
             available: boolean;
             expires_at: string;
         }[];
         received_at: string;
         created_at: string;
-    }[];
-};
+        direction: "outbound";
+        status: "draft" | "sent";
+        email_id: string | null;
+        delivery: string | null;
+    })[];
+}
 type ThreadsUpdateParams = {
     id: string;
 } & {
@@ -3346,24 +4648,24 @@ type ThreadsUpdateParams = {
     spam?: boolean;
     unread?: boolean;
 };
-type ThreadsUpdateResponse = {
-    object: string;
+interface ThreadsUpdateResponse {
+    object: "inbox_thread";
     id: string;
     inbox_id: string;
-    subject: string;
-    status: string;
+    subject: string | null;
+    status: "open" | "pending" | "done" | "archived";
     spam: boolean;
     labels: string[];
-    assignee_user_id: unknown;
-    assignee_agent: string;
+    assignee_user_id: string | null;
+    assignee_agent: string | null;
     message_count: number;
     unread: boolean;
     participants: string[];
     last_message_at: string;
-    last_inbound_at: string;
+    last_inbound_at: string | null;
     created_at: string;
     updated_at: string;
-};
+}
 type ThreadsReplyParams = {
     id: string;
 } & {
@@ -3395,101 +4697,167 @@ type ThreadsReplyParams = {
     status?: "open" | "pending" | "done" | "archived";
 };
 type ThreadsReplyResponse = {
-    object: string;
+    object: "inbox_message";
     id: string;
-    thread_id: string;
+    thread_id: string | null;
     inbox_id: string;
-    direction: string;
-    status: string;
     from: string;
     from_address: string;
-    from_name: string;
+    from_name: string | null;
     to: string[];
-    cc: unknown[];
-    reply_to: unknown[];
-    subject: string;
-    text: string;
-    html: string;
-    snippet: string;
+    cc: string[];
+    reply_to: string[];
+    subject: string | null;
+    text: string | null;
+    html: string | null;
+    snippet: string | null;
     remote_images: number;
     body_truncated: boolean;
-    message_id: string;
-    in_reply_to: unknown;
-    references: unknown[];
-    spam: {
-        score: number;
-        verdict: string;
-        virus: string;
-        spf: string;
-        dkim: string;
-        dmarc: string;
-        reasons: unknown[];
-    };
-    auto_submitted: boolean;
-    automation_reason: unknown;
+    message_id: string | null;
+    in_reply_to: string | null;
+    references: string[];
     attachments: {
         id: string;
         filename: string;
         content_type: string;
         size: number;
         inline: boolean;
-        content_id: unknown;
+        content_id: string | null;
         available: boolean;
         expires_at: string;
     }[];
     received_at: string;
     created_at: string;
+    direction: "outbound";
+    status: "sent";
     email_id: string;
     delivery: string;
+} | {
+    object: "inbox_message";
+    id: string;
+    thread_id: string | null;
+    inbox_id: string;
+    from: string;
+    from_address: string;
+    from_name: string | null;
+    to: string[];
+    cc: string[];
+    reply_to: string[];
+    subject: string | null;
+    text: string | null;
+    html: string | null;
+    snippet: string | null;
+    remote_images: number;
+    body_truncated: boolean;
+    message_id: string | null;
+    in_reply_to: string | null;
+    references: string[];
+    attachments: {
+        id: string;
+        filename: string;
+        content_type: string;
+        size: number;
+        inline: boolean;
+        content_id: string | null;
+        available: boolean;
+        expires_at: string;
+    }[];
+    received_at: string;
+    created_at: string;
+    direction: "outbound";
+    status: "draft";
+    email_id: string | null;
+    delivery: string | null;
+} | {
+    object: "inbox_message";
+    id: string;
+    email_id: string;
+    status: "sent";
 };
 interface MessagesGetParams {
     id: string;
 }
 type MessagesGetResponse = {
-    object: string;
+    object: "inbox_message";
     id: string;
-    thread_id: string;
+    thread_id: string | null;
     inbox_id: string;
-    direction: string;
-    status: string;
     from: string;
     from_address: string;
-    from_name: string;
+    from_name: string | null;
     to: string[];
-    cc: unknown[];
-    reply_to: unknown[];
-    subject: string;
-    text: string;
-    html: string;
-    snippet: string;
+    cc: string[];
+    reply_to: string[];
+    subject: string | null;
+    text: string | null;
+    html: string | null;
+    snippet: string | null;
     remote_images: number;
     body_truncated: boolean;
-    message_id: string;
-    in_reply_to: unknown;
-    references: unknown[];
+    message_id: string | null;
+    in_reply_to: string | null;
+    references: string[];
+    attachments: {
+        id: string;
+        filename: string;
+        content_type: string;
+        size: number;
+        inline: boolean;
+        content_id: string | null;
+        available: boolean;
+        expires_at: string;
+    }[];
+    received_at: string;
+    created_at: string;
+    direction: "inbound";
+    status: "inbox" | "spam";
     spam: {
-        score: number;
-        verdict: string;
-        virus: string;
-        spf: string;
-        dkim: string;
-        dmarc: string;
-        reasons: unknown[];
+        score: number | null;
+        verdict: string | null;
+        virus: string | null;
+        spf: string | null;
+        dkim: string | null;
+        dmarc: string | null;
+        reasons: string[];
     };
     auto_submitted: boolean;
-    automation_reason: unknown;
+    automation_reason: string | null;
+} | {
+    object: "inbox_message";
+    id: string;
+    thread_id: string | null;
+    inbox_id: string;
+    from: string;
+    from_address: string;
+    from_name: string | null;
+    to: string[];
+    cc: string[];
+    reply_to: string[];
+    subject: string | null;
+    text: string | null;
+    html: string | null;
+    snippet: string | null;
+    remote_images: number;
+    body_truncated: boolean;
+    message_id: string | null;
+    in_reply_to: string | null;
+    references: string[];
     attachments: {
         id: string;
         filename: string;
         content_type: string;
         size: number;
         inline: boolean;
-        content_id: unknown;
+        content_id: string | null;
         available: boolean;
         expires_at: string;
     }[];
     received_at: string;
     created_at: string;
+    direction: "outbound";
+    status: "draft" | "sent";
+    email_id: string | null;
+    delivery: string | null;
 };
 type MessagesUpdateParams = {
     id: string;
@@ -3498,124 +4866,111 @@ type MessagesUpdateParams = {
     html?: string | null;
     cc?: string[];
 };
-type MessagesUpdateResponse = {
-    object: string;
+interface MessagesUpdateResponse {
+    object: "inbox_message";
     id: string;
-    thread_id: string;
+    thread_id: string | null;
     inbox_id: string;
-    direction: string;
-    status: string;
     from: string;
     from_address: string;
-    from_name: string;
+    from_name: string | null;
     to: string[];
-    cc: unknown[];
-    reply_to: unknown[];
-    subject: string;
-    text: string;
-    html: string;
-    snippet: string;
+    cc: string[];
+    reply_to: string[];
+    subject: string | null;
+    text: string | null;
+    html: string | null;
+    snippet: string | null;
     remote_images: number;
     body_truncated: boolean;
-    message_id: string;
-    in_reply_to: unknown;
-    references: unknown[];
-    spam: {
-        score: number;
-        verdict: string;
-        virus: string;
-        spf: string;
-        dkim: string;
-        dmarc: string;
-        reasons: unknown[];
-    };
-    auto_submitted: boolean;
-    automation_reason: unknown;
+    message_id: string | null;
+    in_reply_to: string | null;
+    references: string[];
     attachments: {
         id: string;
         filename: string;
         content_type: string;
         size: number;
         inline: boolean;
-        content_id: unknown;
+        content_id: string | null;
         available: boolean;
         expires_at: string;
     }[];
     received_at: string;
     created_at: string;
-};
+    direction: "outbound";
+    status: "draft" | "sent";
+    email_id: string | null;
+    delivery: string | null;
+}
 type MessagesSendParams = {
     id: string;
 } & {
     status?: "open" | "pending" | "done" | "archived";
 };
 type MessagesSendResponse = {
-    object: string;
+    object: "inbox_message";
     id: string;
-    thread_id: string;
+    thread_id: string | null;
     inbox_id: string;
-    direction: string;
-    status: string;
     from: string;
     from_address: string;
-    from_name: string;
+    from_name: string | null;
     to: string[];
-    cc: unknown[];
-    reply_to: unknown[];
-    subject: string;
-    text: string;
-    html: string;
-    snippet: string;
+    cc: string[];
+    reply_to: string[];
+    subject: string | null;
+    text: string | null;
+    html: string | null;
+    snippet: string | null;
     remote_images: number;
     body_truncated: boolean;
-    message_id: string;
-    in_reply_to: unknown;
-    references: unknown[];
-    spam: {
-        score: number;
-        verdict: string;
-        virus: string;
-        spf: string;
-        dkim: string;
-        dmarc: string;
-        reasons: unknown[];
-    };
-    auto_submitted: boolean;
-    automation_reason: unknown;
+    message_id: string | null;
+    in_reply_to: string | null;
+    references: string[];
     attachments: {
         id: string;
         filename: string;
         content_type: string;
         size: number;
         inline: boolean;
-        content_id: unknown;
+        content_id: string | null;
         available: boolean;
         expires_at: string;
     }[];
     received_at: string;
     created_at: string;
+    direction: "outbound";
+    status: "sent";
+    email_id: string;
+    delivery: string;
+} | {
+    object: "inbox_message";
+    id: string;
+    email_id: string;
+    status: "sent";
 };
 interface MessagesRemoveParams {
     id: string;
 }
-type MessagesRemoveResponse = {
-    object: string;
+interface MessagesRemoveResponse {
+    object: "inbox_message";
     id: string;
-    deleted: boolean;
-};
+    deleted: true;
+}
 interface MessagesAttachmentParams {
     id: string;
     attachmentId: string;
 }
-type MessagesAttachmentResponse = {
-    object: string;
+interface MessagesAttachmentResponse {
+    object: "attachment_url";
     id: string;
     filename: string;
     content_type: string;
     size: number;
     url: string;
     expires_at: string;
-};
+}
 
 interface SmartletterResources {
     emails: {