telnyx 7.12.0 → 7.13.0

package/resources/email-templates.js

@@ -0,0 +1,124 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailTemplates = void 0;
+const resource_1 = require("../core/resource.js");
+const headers_1 = require("../internal/headers.js");
+const path_1 = require("../internal/utils/path.js");
+/**
+ * Create, list, retrieve, update, delete, and render Liquid email templates.
+ */
+class EmailTemplates extends resource_1.APIResource {
+    /**
+     * Lists templates sorted newest first by `created_at desc, id desc`.
+     *
+     * @example
+     * ```ts
+     * const emailTemplates = await client.emailTemplates.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/email_templates', { query, ...options });
+    }
+    /**
+     * Creates a Liquid email template. Variables are auto-extracted when omitted.
+     *
+     * @example
+     * ```ts
+     * const emailTemplateResponse =
+     *   await client.emailTemplates.create({
+     *     name: 'Welcome Email',
+     *     html_body: '<h1>Hello {{ first_name }}</h1>',
+     *     subject: 'Welcome, {{ first_name }}!',
+     *     text_body: 'Hello {{ first_name }}',
+     *   });
+     * ```
+     */
+    create(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/email_templates', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Delete an email template
+     *
+     * @example
+     * ```ts
+     * await client.emailTemplates.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/email_templates/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Get an email template
+     *
+     * @example
+     * ```ts
+     * const emailTemplateResponse =
+     *   await client.emailTemplates.retrieve(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get((0, path_1.path) `/email_templates/${id}`, options);
+    }
+    /**
+     * Replaces template fields. Behaves identically to PATCH; provided for
+     * compatibility with Phoenix resource routes.
+     *
+     * @example
+     * ```ts
+     * const emailTemplateResponse =
+     *   await client.emailTemplates.replace(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    replace(id, body, options) {
+        return this._client.put((0, path_1.path) `/email_templates/${id}`, { body, ...options });
+    }
+    /**
+     * Updates one or more template fields.
+     *
+     * @example
+     * ```ts
+     * const emailTemplateResponse =
+     *   await client.emailTemplates.update(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    update(id, body, options) {
+        return this._client.patch((0, path_1.path) `/email_templates/${id}`, { body, ...options });
+    }
+    /**
+     * Renders a template using the provided Liquid variables. Missing
+     * `template_variables` defaults to `{}`.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emailTemplates.render(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { template_variables: { first_name: 'Ada' } },
+     * );
+     * ```
+     */
+    render(id, body = {}, options) {
+        return this._client.post((0, path_1.path) `/email_templates/${id}/render`, { body, ...options });
+    }
+}
+exports.EmailTemplates = EmailTemplates;
+//# sourceMappingURL=email-templates.js.map

package/resources/email-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-templates.js","sourceRoot":"","sources":["../src/resources/email-templates.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,oDAAmD;AAEnD,oDAA8C;AAE9C;;GAEG;AACH,MAAa,cAAe,SAAQ,sBAAW;IAC7C;;;;;;;OAOG;IACH,IAAI,CACF,QAAoD,EAAE,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,MAAiC,EAAE,OAAwB;QAChE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE;YAC3C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,EAAE,EAAE;YACvD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CACL,EAAU,EACV,IAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CACJ,EAAU,EACV,IAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,EAAU,EACV,OAAqD,EAAE,EACvD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;CACF;AApID,wCAoIC"}

package/resources/email-templates.mjs

@@ -0,0 +1,120 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+import { path } from "../internal/utils/path.mjs";
+/**
+ * Create, list, retrieve, update, delete, and render Liquid email templates.
+ */
+export class EmailTemplates extends APIResource {
+    /**
+     * Lists templates sorted newest first by `created_at desc, id desc`.
+     *
+     * @example
+     * ```ts
+     * const emailTemplates = await client.emailTemplates.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/email_templates', { query, ...options });
+    }
+    /**
+     * Creates a Liquid email template. Variables are auto-extracted when omitted.
+     *
+     * @example
+     * ```ts
+     * const emailTemplateResponse =
+     *   await client.emailTemplates.create({
+     *     name: 'Welcome Email',
+     *     html_body: '<h1>Hello {{ first_name }}</h1>',
+     *     subject: 'Welcome, {{ first_name }}!',
+     *     text_body: 'Hello {{ first_name }}',
+     *   });
+     * ```
+     */
+    create(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/email_templates', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Delete an email template
+     *
+     * @example
+     * ```ts
+     * await client.emailTemplates.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete(path `/email_templates/${id}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Get an email template
+     *
+     * @example
+     * ```ts
+     * const emailTemplateResponse =
+     *   await client.emailTemplates.retrieve(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get(path `/email_templates/${id}`, options);
+    }
+    /**
+     * Replaces template fields. Behaves identically to PATCH; provided for
+     * compatibility with Phoenix resource routes.
+     *
+     * @example
+     * ```ts
+     * const emailTemplateResponse =
+     *   await client.emailTemplates.replace(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    replace(id, body, options) {
+        return this._client.put(path `/email_templates/${id}`, { body, ...options });
+    }
+    /**
+     * Updates one or more template fields.
+     *
+     * @example
+     * ```ts
+     * const emailTemplateResponse =
+     *   await client.emailTemplates.update(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    update(id, body, options) {
+        return this._client.patch(path `/email_templates/${id}`, { body, ...options });
+    }
+    /**
+     * Renders a template using the provided Liquid variables. Missing
+     * `template_variables` defaults to `{}`.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emailTemplates.render(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   { template_variables: { first_name: 'Ada' } },
+     * );
+     * ```
+     */
+    render(id, body = {}, options) {
+        return this._client.post(path `/email_templates/${id}/render`, { body, ...options });
+    }
+}
+//# sourceMappingURL=email-templates.mjs.map

package/resources/email-templates.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-templates.mjs","sourceRoot":"","sources":["../src/resources/email-templates.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAI/C,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAEnD,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC7C;;;;;;;OAOG;IACH,IAAI,CACF,QAAoD,EAAE,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,MAAiC,EAAE,OAAwB;QAChE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE;YAC3C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,oBAAoB,EAAE,EAAE,EAAE;YACvD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,oBAAoB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CACL,EAAU,EACV,IAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,oBAAoB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CACJ,EAAU,EACV,IAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,oBAAoB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,EAAU,EACV,OAAqD,EAAE,EACvD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,oBAAoB,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;CACF"}

package/resources/email-threads.d.mts

@@ -0,0 +1,71 @@
+import { APIResource } from "../core/resource.mjs";
+import * as ThreadsAPI from "./email-inboxes/threads/threads.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+/**
+ * Account-wide conversation threads across every inbox, for agents operating many inboxes at once.
+ */
+export declare class EmailThreads extends APIResource {
+    /**
+     * Lists thread summaries for the whole account, newest first, using stable cursor
+     * pagination. An agent operating many inboxes gets every conversation in one call
+     * instead of one call per inbox. Each thread carries its own `inbox_id` so a reply
+     * can be routed back to the right inbox. Use `filter[inbox_id]` (repeatable) to
+     * narrow the result to specific inboxes. Because a thread ID can be delivered to
+     * multiple inboxes, each result is identified by its `(inbox_id, id)` pair.
+     */
+    list(query?: EmailThreadListParams | null | undefined, options?: RequestOptions): APIPromise<ThreadsAPI.InboundThreadListResponse>;
+    /**
+     * Returns a thread and a bounded page of its inbound and outbound messages,
+     * interleaved in chronological order. The `inbox_id` returned by the list endpoint
+     * is required because a thread ID can occur in multiple inboxes. Only messages
+     * matching that `(inbox_id, thread_id)` pair are returned. Threads outside the
+     * account return an opaque 404.
+     */
+    retrieve(threadID: string, query: EmailThreadRetrieveParams, options?: RequestOptions): APIPromise<EmailThreadRetrieveResponse>;
+}
+export interface EmailThreadRetrieveResponse {
+    data: ThreadsAPI.InboundThreadDetail;
+    meta: ThreadsAPI.EmailPaginationMeta;
+}
+export interface EmailThreadListParams {
+    /**
+     * Restrict results to one or more inboxes. Repeat the parameter
+     * (`filter[inbox_id][]=...&filter[inbox_id][]=...`) or pass a comma-separated
+     * list. Omit to list every inbox in the account. Inboxes outside the account are
+     * silently excluded. If the filter is present, it must contain at least one
+     * non-empty UUID.
+     */
+    'filter[inbox_id]'?: Array<string>;
+    /**
+     * Returns only threads carrying this label. Matching is exact and case-sensitive.
+     * Thread labels are independent of the labels on the thread's messages.
+     */
+    'filter[label]'?: string;
+    /**
+     * Opaque cursor returned by the previous page.
+     */
+    'page[after]'?: string;
+    /**
+     * Number of results to return. Defaults to 25; maximum is 100.
+     */
+    'page[size]'?: number;
+}
+export interface EmailThreadRetrieveParams {
+    /**
+     * Inbox UUID that, together with `thread_id`, identifies the thread.
+     */
+    inbox_id: string;
+    /**
+     * Opaque message cursor returned by the previous thread-detail page.
+     */
+    'page[after]'?: string;
+    /**
+     * Number of thread messages to return. Defaults to 25; maximum is 100.
+     */
+    'page[size]'?: number;
+}
+export declare namespace EmailThreads {
+    export { type EmailThreadRetrieveResponse as EmailThreadRetrieveResponse, type EmailThreadListParams as EmailThreadListParams, type EmailThreadRetrieveParams as EmailThreadRetrieveParams, };
+}
+//# sourceMappingURL=email-threads.d.mts.map

package/resources/email-threads.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-threads.d.mts","sourceRoot":"","sources":["../src/resources/email-threads.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,KAAK,UAAU,4CAAwC;AAC9D,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAG7D;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;OAOG;IACH,IAAI,CACF,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,UAAU,CAAC,yBAAyB,CAAC;IAInD;;;;;;OAMG;IACH,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,yBAAyB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,2BAA2B,CAAC;CAG3C;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC;IAErC,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEnC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,yBAAyB,IAAI,yBAAyB,GAC5D,CAAC;CACH"}

package/resources/email-threads.d.ts

@@ -0,0 +1,71 @@
+import { APIResource } from "../core/resource.js";
+import * as ThreadsAPI from "./email-inboxes/threads/threads.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Account-wide conversation threads across every inbox, for agents operating many inboxes at once.
+ */
+export declare class EmailThreads extends APIResource {
+    /**
+     * Lists thread summaries for the whole account, newest first, using stable cursor
+     * pagination. An agent operating many inboxes gets every conversation in one call
+     * instead of one call per inbox. Each thread carries its own `inbox_id` so a reply
+     * can be routed back to the right inbox. Use `filter[inbox_id]` (repeatable) to
+     * narrow the result to specific inboxes. Because a thread ID can be delivered to
+     * multiple inboxes, each result is identified by its `(inbox_id, id)` pair.
+     */
+    list(query?: EmailThreadListParams | null | undefined, options?: RequestOptions): APIPromise<ThreadsAPI.InboundThreadListResponse>;
+    /**
+     * Returns a thread and a bounded page of its inbound and outbound messages,
+     * interleaved in chronological order. The `inbox_id` returned by the list endpoint
+     * is required because a thread ID can occur in multiple inboxes. Only messages
+     * matching that `(inbox_id, thread_id)` pair are returned. Threads outside the
+     * account return an opaque 404.
+     */
+    retrieve(threadID: string, query: EmailThreadRetrieveParams, options?: RequestOptions): APIPromise<EmailThreadRetrieveResponse>;
+}
+export interface EmailThreadRetrieveResponse {
+    data: ThreadsAPI.InboundThreadDetail;
+    meta: ThreadsAPI.EmailPaginationMeta;
+}
+export interface EmailThreadListParams {
+    /**
+     * Restrict results to one or more inboxes. Repeat the parameter
+     * (`filter[inbox_id][]=...&filter[inbox_id][]=...`) or pass a comma-separated
+     * list. Omit to list every inbox in the account. Inboxes outside the account are
+     * silently excluded. If the filter is present, it must contain at least one
+     * non-empty UUID.
+     */
+    'filter[inbox_id]'?: Array<string>;
+    /**
+     * Returns only threads carrying this label. Matching is exact and case-sensitive.
+     * Thread labels are independent of the labels on the thread's messages.
+     */
+    'filter[label]'?: string;
+    /**
+     * Opaque cursor returned by the previous page.
+     */
+    'page[after]'?: string;
+    /**
+     * Number of results to return. Defaults to 25; maximum is 100.
+     */
+    'page[size]'?: number;
+}
+export interface EmailThreadRetrieveParams {
+    /**
+     * Inbox UUID that, together with `thread_id`, identifies the thread.
+     */
+    inbox_id: string;
+    /**
+     * Opaque message cursor returned by the previous thread-detail page.
+     */
+    'page[after]'?: string;
+    /**
+     * Number of thread messages to return. Defaults to 25; maximum is 100.
+     */
+    'page[size]'?: number;
+}
+export declare namespace EmailThreads {
+    export { type EmailThreadRetrieveResponse as EmailThreadRetrieveResponse, type EmailThreadListParams as EmailThreadListParams, type EmailThreadRetrieveParams as EmailThreadRetrieveParams, };
+}
+//# sourceMappingURL=email-threads.d.ts.map

package/resources/email-threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-threads.d.ts","sourceRoot":"","sources":["../src/resources/email-threads.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,KAAK,UAAU,2CAAwC;AAC9D,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAG7D;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;OAOG;IACH,IAAI,CACF,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,UAAU,CAAC,yBAAyB,CAAC;IAInD;;;;;;OAMG;IACH,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,yBAAyB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,2BAA2B,CAAC;CAG3C;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC;IAErC,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEnC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,yBAAyB,IAAI,yBAAyB,GAC5D,CAAC;CACH"}

package/resources/email-threads.js

@@ -0,0 +1,34 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailThreads = void 0;
+const resource_1 = require("../core/resource.js");
+const path_1 = require("../internal/utils/path.js");
+/**
+ * Account-wide conversation threads across every inbox, for agents operating many inboxes at once.
+ */
+class EmailThreads extends resource_1.APIResource {
+    /**
+     * Lists thread summaries for the whole account, newest first, using stable cursor
+     * pagination. An agent operating many inboxes gets every conversation in one call
+     * instead of one call per inbox. Each thread carries its own `inbox_id` so a reply
+     * can be routed back to the right inbox. Use `filter[inbox_id]` (repeatable) to
+     * narrow the result to specific inboxes. Because a thread ID can be delivered to
+     * multiple inboxes, each result is identified by its `(inbox_id, id)` pair.
+     */
+    list(query = {}, options) {
+        return this._client.get('/email_threads', { query, ...options });
+    }
+    /**
+     * Returns a thread and a bounded page of its inbound and outbound messages,
+     * interleaved in chronological order. The `inbox_id` returned by the list endpoint
+     * is required because a thread ID can occur in multiple inboxes. Only messages
+     * matching that `(inbox_id, thread_id)` pair are returned. Threads outside the
+     * account return an opaque 404.
+     */
+    retrieve(threadID, query, options) {
+        return this._client.get((0, path_1.path) `/email_threads/${threadID}`, { query, ...options });
+    }
+}
+exports.EmailThreads = EmailThreads;
+//# sourceMappingURL=email-threads.js.map

package/resources/email-threads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-threads.js","sourceRoot":"","sources":["../src/resources/email-threads.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,oDAA8C;AAE9C;;GAEG;AACH,MAAa,YAAa,SAAQ,sBAAW;IAC3C;;;;;;;OAOG;IACH,IAAI,CACF,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CACN,QAAgB,EAChB,KAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,kBAAkB,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;CACF;AA9BD,oCA8BC"}

package/resources/email-threads.mjs

@@ -0,0 +1,30 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { path } from "../internal/utils/path.mjs";
+/**
+ * Account-wide conversation threads across every inbox, for agents operating many inboxes at once.
+ */
+export class EmailThreads extends APIResource {
+    /**
+     * Lists thread summaries for the whole account, newest first, using stable cursor
+     * pagination. An agent operating many inboxes gets every conversation in one call
+     * instead of one call per inbox. Each thread carries its own `inbox_id` so a reply
+     * can be routed back to the right inbox. Use `filter[inbox_id]` (repeatable) to
+     * narrow the result to specific inboxes. Because a thread ID can be delivered to
+     * multiple inboxes, each result is identified by its `(inbox_id, id)` pair.
+     */
+    list(query = {}, options) {
+        return this._client.get('/email_threads', { query, ...options });
+    }
+    /**
+     * Returns a thread and a bounded page of its inbound and outbound messages,
+     * interleaved in chronological order. The `inbox_id` returned by the list endpoint
+     * is required because a thread ID can occur in multiple inboxes. Only messages
+     * matching that `(inbox_id, thread_id)` pair are returned. Threads outside the
+     * account return an opaque 404.
+     */
+    retrieve(threadID, query, options) {
+        return this._client.get(path `/email_threads/${threadID}`, { query, ...options });
+    }
+}
+//# sourceMappingURL=email-threads.mjs.map

package/resources/email-threads.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-threads.mjs","sourceRoot":"","sources":["../src/resources/email-threads.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAI/C,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C;;;;;;;OAOG;IACH,IAAI,CACF,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CACN,QAAgB,EAChB,KAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,kBAAkB,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;CACF"}

package/resources/email-unsubscribe-groups/email-unsubscribe-groups.d.mts

@@ -0,0 +1,90 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as SuppressionsAPI from "./suppressions.mjs";
+import { SuppressionCreateParams, SuppressionDeleteParams, SuppressionListParams, Suppressions } from "./suppressions.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { DefaultFlatPagination, type DefaultFlatPaginationParams, PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+/**
+ * Named groups and group-scoped suppressions.
+ */
+export declare class EmailUnsubscribeGroups extends APIResource {
+    suppressions: SuppressionsAPI.Suppressions;
+    /**
+     * Offset pagination only (`page[number]` default 1, `page[size]` default 25, max
+     * 100). No `sort`/`filter`/cursor — ordering fixed `desc created_at, desc id`.
+     * Uses the shared `QueryParser.parse_offset/1` — a malformed `page` (e.g. flat
+     * `?page=1` instead of `?page[number]=1`) returns `400` (code `10015`), consistent
+     * with `GET /v2/email_blocks`. `meta` includes `total_pages`.
+     */
+    list(query?: EmailUnsubscribeGroupListParams | null | undefined, options?: RequestOptions): PagePromise<UnsubscribeGroupsDefaultFlatPagination, UnsubscribeGroup>;
+    /**
+     * Create an unsubscribe group
+     */
+    create(body: EmailUnsubscribeGroupCreateParams, options?: RequestOptions): APIPromise<UnsubscribeGroupResponse>;
+    /**
+     * If the group has 0 active suppressions, hard-deletes the row. With `force=true`,
+     * soft-deletes all active suppressions first (status → `removed`, `group_id`
+     * cleared, `removed` audit event per block) in a single transaction, then
+     * hard-deletes the group. Without `force` and active suppressions present → `409`.
+     * Audit trail is preserved. `force` only accepts the string `"true"` or boolean
+     * `true`; all other values are false.
+     */
+    delete(id: string, params?: EmailUnsubscribeGroupDeleteParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Retrieve an unsubscribe group
+     */
+    retrieve(id: string, options?: RequestOptions): APIPromise<UnsubscribeGroupResponse>;
+    /**
+     * Partial update (only `name` / `description`). `PUT` is not routed.
+     */
+    update(id: string, body: EmailUnsubscribeGroupUpdateParams, options?: RequestOptions): APIPromise<UnsubscribeGroupResponse>;
+}
+export type UnsubscribeGroupsDefaultFlatPagination = DefaultFlatPagination<UnsubscribeGroup>;
+/**
+ * Group list `meta` (consistent with `GET /v2/email_blocks`).
+ */
+export interface GroupListMeta {
+    page_number: number;
+    page_size: number;
+    total_pages: number;
+    total_results: number;
+}
+export interface UnsubscribeGroup {
+    id: string;
+    created_at: string;
+    /**
+     * Always present (not omit-nullable); `null` when unset.
+     */
+    description: string | null;
+    name: string;
+    /**
+     * View-only.
+     */
+    record_type: 'email_unsubscribe_group';
+    updated_at: string;
+}
+export interface UnsubscribeGroupResponse {
+    data: UnsubscribeGroup;
+}
+export interface EmailUnsubscribeGroupListParams extends DefaultFlatPaginationParams {
+}
+export interface EmailUnsubscribeGroupCreateParams {
+    name: string;
+    description?: string | null;
+}
+export interface EmailUnsubscribeGroupDeleteParams {
+    /**
+     * Force-delete a group with active suppressions. Only `"true"` (string) or `true`
+     * (bool) are truthy; all other values are false.
+     */
+    force?: 'true' | 'false' | boolean;
+}
+export interface EmailUnsubscribeGroupUpdateParams {
+    description?: string | null;
+    name?: string;
+}
+export declare namespace EmailUnsubscribeGroups {
+    export { type GroupListMeta as GroupListMeta, type UnsubscribeGroup as UnsubscribeGroup, type UnsubscribeGroupResponse as UnsubscribeGroupResponse, type UnsubscribeGroupsDefaultFlatPagination as UnsubscribeGroupsDefaultFlatPagination, type EmailUnsubscribeGroupListParams as EmailUnsubscribeGroupListParams, type EmailUnsubscribeGroupCreateParams as EmailUnsubscribeGroupCreateParams, type EmailUnsubscribeGroupDeleteParams as EmailUnsubscribeGroupDeleteParams, type EmailUnsubscribeGroupUpdateParams as EmailUnsubscribeGroupUpdateParams, };
+    export { Suppressions as Suppressions, type SuppressionListParams as SuppressionListParams, type SuppressionCreateParams as SuppressionCreateParams, type SuppressionDeleteParams as SuppressionDeleteParams, };
+}
+//# sourceMappingURL=email-unsubscribe-groups.d.mts.map

package/resources/email-unsubscribe-groups/email-unsubscribe-groups.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-unsubscribe-groups.d.mts","sourceRoot":"","sources":["../../src/resources/email-unsubscribe-groups/email-unsubscribe-groups.ts"],"names":[],"mappings":"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"}