@unboundcx/sdk 4.11.1 → 4.13.0

package/index.js

@@ -15,6 +15,8 @@ import { WorkflowsService } from './services/workflows.js';
 import { NotesService } from './services/notes.js';
 import { StorageService } from './services/storage.js';
 import { BrandingService } from './services/branding.js';
+import { BrandService } from './services/brand.js';
+import { ContentService } from './services/content.js';
 import { VerificationService } from './services/verification.js';
 import { PortalsService } from './services/portals.js';
 import { SipEndpointsService } from './services/sipEndpoints.js';
@@ -93,6 +95,8 @@ class UnboundSDK extends BaseSDK {
     this.notes = new NotesService(this);
     this.storage = new StorageService(this);
     this.branding = new BrandingService(this);
+    this.brand = new BrandService(this);
+    this.content = new ContentService(this);
     this.verification = new VerificationService(this);
     this.portals = new PortalsService(this);
     this.sipEndpoints = new SipEndpointsService(this);
@@ -275,6 +279,13 @@ export { WorkflowsService } from './services/workflows.js';
 export { NotesService } from './services/notes.js';
 export { StorageService } from './services/storage.js';
 export { BrandingService, BrandingEmailTemplatesService } from './services/branding.js';
+export { BrandService, BrandKitsService } from './services/brand.js';
+export {
+  ContentService,
+  ContentBlocksService,
+  ContentLibraryService,
+  ContentStockService,
+} from './services/content.js';
 export { VerificationService } from './services/verification.js';
 export { PortalsService } from './services/portals.js';
 export { SipEndpointsService } from './services/sipEndpoints.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.11.1",
+  "version": "4.13.0",
   "description": "Official JavaScript SDK for the Unbound API - A comprehensive toolkit for integrating with Unbound's communication, AI, and data management services",
   "main": "index.js",
   "type": "module",

package/services/ai/email.js

@@ -0,0 +1,116 @@
+import { internalRequest } from '../../base.js';
+
+function pickDefined(fields) {
+  const body = {};
+  for (const [key, value] of Object.entries(fields)) {
+    if (value !== undefined) body[key] = value;
+  }
+  return body;
+}
+
+/**
+ * Email generation via SpaceXAI. `sdk.ai.email.*`.
+ *
+ * @see app1-api src/services/ai/routes/email.js
+ */
+export class EmailService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * Generate or revise an email as a block-tree document.
+   *
+   * @param {Object} params
+   * @param {string} params.prompt - Generation prompt (required)
+   * @param {string} [params.brandKitId] - Brand kit to apply
+   * @param {string} [params.appearance] - `client` or `marketing`
+   * @param {Object|Array} [params.tree] - Existing block tree to revise
+   * @returns {Promise<Object>} `{ tree }`
+   */
+  async generate({ prompt, brandKitId, appearance, tree } = {}) {
+    this.sdk.validateParams(
+      { prompt, brandKitId, appearance, tree },
+      {
+        prompt: { type: 'string', required: true },
+        brandKitId: { type: 'string', required: false },
+        appearance: { type: 'string', required: false },
+        tree: { type: 'object', required: false },
+      },
+    );
+
+    return internalRequest(this.sdk, '/ai/email/generate', 'POST', {
+      body: pickDefined({ prompt, brandKitId, appearance, tree }),
+    });
+  }
+
+  /**
+   * Rewrite email copy.
+   *
+   * @param {Object} params
+   * @param {string} params.text - Source copy (required)
+   * @param {string} params.instruction - `tone` | `shorten` | `expand` | `translate`
+   * @param {string} [params.lang] - Target language (required when `translate`)
+   * @returns {Promise<Object>} `{ text }`
+   */
+  async rewrite({ text, instruction, lang } = {}) {
+    this.sdk.validateParams(
+      { text, instruction, lang },
+      {
+        text: { type: 'string', required: true },
+        instruction: { type: 'string', required: true },
+        lang: { type: 'string', required: false },
+      },
+    );
+
+    return internalRequest(this.sdk, '/ai/email/rewrite', 'POST', {
+      body: pickDefined({ text, instruction, lang }),
+    });
+  }
+
+  /**
+   * Generate subject + preheader variants.
+   *
+   * @param {Object} params
+   * @param {string} [params.html] - Rendered email HTML
+   * @param {string} [params.prompt] - Prompt describing the email
+   * @param {number} [params.n] - Variant count (1–5, default 3)
+   * @returns {Promise<Object>} `{ variants: [{ subject, preheader }] }`
+   */
+  async subjects({ html, prompt, n } = {}) {
+    this.sdk.validateParams(
+      { html, prompt, n },
+      {
+        html: { type: 'string', required: false },
+        prompt: { type: 'string', required: false },
+        n: { type: 'number', required: false },
+      },
+    );
+
+    return internalRequest(this.sdk, '/ai/email/subjects', 'POST', {
+      body: pickDefined({ html, prompt, n }),
+    });
+  }
+
+  /**
+   * Generate image alt text.
+   *
+   * @param {Object} params
+   * @param {string} [params.imageUrl] - https or data:image URL
+   * @param {string} [params.description] - Image description
+   * @returns {Promise<Object>} `{ alt }`
+   */
+  async altText({ imageUrl, description } = {}) {
+    this.sdk.validateParams(
+      { imageUrl, description },
+      {
+        imageUrl: { type: 'string', required: false },
+        description: { type: 'string', required: false },
+      },
+    );
+
+    return internalRequest(this.sdk, '/ai/email/alt-text', 'POST', {
+      body: pickDefined({ imageUrl, description }),
+    });
+  }
+}

package/services/ai.js

@@ -1,6 +1,7 @@
 import { internalRequest } from '../base.js';
 import { PlaybooksService } from './ai/playbooks.js';
 import { VocabularyService } from './ai/vocabulary.js';
+import { EmailService } from './ai/email.js';
 import { translate as translateItems } from './ai/translate.js';
 import {
   getSettings as getAiSettings,
@@ -16,6 +17,7 @@ export class AIService {
     this.extract = new ExtractService(sdk);
     this.playbooks = new PlaybooksService(sdk);
     this.vocabulary = new VocabularyService(sdk);
+    this.email = new EmailService(sdk);
   }
 
   /**

package/services/brand.js

@@ -0,0 +1,166 @@
+import { internalRequest } from '../base.js';
+
+function pickDefined(fields) {
+  const body = {};
+  for (const [key, value] of Object.entries(fields)) {
+    if (value !== undefined) body[key] = value;
+  }
+  return body;
+}
+
+/**
+ * Tenant brand kits used in content we send/host (emails, later landing
+ * pages). Distinct from white-label `sdk.branding`.
+ *
+ * @see app1-api src/services/brand/routes.js
+ */
+export class BrandService {
+  constructor(sdk) {
+    this.sdk = sdk;
+    this.kits = new BrandKitsService(sdk);
+  }
+}
+
+/**
+ * Brand kit CRUD + URL extract. `sdk.brand.kits.*`.
+ */
+export class BrandKitsService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * List brand kits for the account. First call may seed a Default kit.
+   *
+   * @returns {Promise<Array>} Kits
+   */
+  async list() {
+    const result = await internalRequest(this.sdk, '/brand/kits', 'GET', {});
+    return result;
+  }
+
+  /**
+   * Create a brand kit.
+   *
+   * @param {Object} params
+   * @param {string} params.name - Kit name (required)
+   * @param {string} [params.logoStorageId]
+   * @param {string} [params.logoDarkStorageId]
+   * @param {string} [params.faviconStorageId]
+   * @param {Object} [params.colors]
+   * @param {Object} [params.fonts]
+   * @param {Object} [params.styles]
+   * @param {Object} [params.socialLinks]
+   * @param {string} [params.legalFooter]
+   * @param {string} [params.websiteUrl]
+   * @param {boolean} [params.isDefault]
+   * @returns {Promise<Object>} Created kit
+   */
+  async create(params = {}) {
+    this.sdk.validateParams(
+      { name: params.name },
+      { name: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(this.sdk, '/brand/kits', 'POST', {
+      body: pickDefined(params),
+    });
+    return result;
+  }
+
+  /**
+   * Get a brand kit by id.
+   *
+   * @param {string} id - Kit id
+   * @returns {Promise<Object>} Kit
+   */
+  async get(id) {
+    this.sdk.validateParams(
+      { id },
+      { id: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(this.sdk, `/brand/kits/${id}`, 'GET', {});
+    return result;
+  }
+
+  /**
+   * Update a brand kit. Only defined fields are sent.
+   *
+   * @param {string} id - Kit id
+   * @param {Object} params - Fields to update
+   * @returns {Promise<Object>} Updated kit
+   */
+  async update(id, params = {}) {
+    this.sdk.validateParams(
+      { id },
+      { id: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(this.sdk, `/brand/kits/${id}`, 'PUT', {
+      body: pickDefined(params),
+    });
+    return result;
+  }
+
+  /**
+   * Delete a brand kit.
+   *
+   * @param {string} id - Kit id
+   * @returns {Promise<Object>} Confirmation
+   */
+  async delete(id) {
+    this.sdk.validateParams(
+      { id },
+      { id: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(
+      this.sdk,
+      `/brand/kits/${id}`,
+      'DELETE',
+      {},
+    );
+    return result;
+  }
+
+  /**
+   * Make this kit the account default. Exactly one kit is default.
+   *
+   * @param {string} id - Kit id
+   * @returns {Promise<Object>} Updated kit
+   */
+  async setDefault(id) {
+    this.sdk.validateParams(
+      { id },
+      { id: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(
+      this.sdk,
+      `/brand/kits/${id}/default`,
+      'POST',
+      {},
+    );
+    return result;
+  }
+
+  /**
+   * Extract a brand-kit proposal from a public https URL. Does not save.
+   *
+   * @param {Object} params
+   * @param {string} params.url - https URL to scrape
+   * @returns {Promise<Object>} Proposal (`logoCandidates`, `colors`, `fonts`)
+   */
+  async extract({ url } = {}) {
+    this.sdk.validateParams(
+      { url },
+      { url: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(this.sdk, '/brand/kits/extract', 'POST', {
+      body: { url },
+    });
+    return result;
+  }
+}

package/services/content.js

@@ -0,0 +1,299 @@
+import { internalRequest } from '../base.js';
+
+function pickDefined(fields) {
+  const body = {};
+  for (const [key, value] of Object.entries(fields)) {
+    if (value !== undefined) body[key] = value;
+  }
+  return body;
+}
+
+/**
+ * Content blocks, template library, and stock imagery.
+ *
+ * @see app1-api src/services/content/routes.js
+ */
+export class ContentService {
+  constructor(sdk) {
+    this.sdk = sdk;
+    this.blocks = new ContentBlocksService(sdk);
+    this.library = new ContentLibraryService(sdk);
+    this.stock = new ContentStockService(sdk);
+  }
+}
+
+/**
+ * Saved / synced content blocks. `sdk.content.blocks.*`.
+ */
+export class ContentBlocksService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * List content blocks.
+   *
+   * @param {Object} [filters]
+   * @param {string} [filters.channel] - `email` or `web`
+   * @param {string} [filters.category]
+   * @param {boolean} [filters.isSynced]
+   * @param {number} [filters.limit]
+   * @returns {Promise<Object>} `{ results }`
+   */
+  async list({ channel, category, isSynced, limit } = {}) {
+    const query = pickDefined({ channel, category, isSynced, limit });
+    const options = Object.keys(query).length ? { query } : {};
+    const result = await internalRequest(
+      this.sdk,
+      '/content/blocks',
+      'GET',
+      options,
+    );
+    return result;
+  }
+
+  /**
+   * Create a content block.
+   *
+   * @param {Object} params
+   * @param {string} params.name - Block name (required)
+   * @param {string} [params.channel]
+   * @param {boolean} [params.isSynced]
+   * @param {string} [params.category]
+   * @param {Object|Array} [params.design] - Block-tree JSON
+   * @param {string} [params.designStorageId]
+   * @param {string} [params.thumbnailStorageId]
+   * @returns {Promise<Object>} Created block
+   */
+  async create(params = {}) {
+    this.sdk.validateParams(
+      { name: params.name },
+      { name: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(this.sdk, '/content/blocks', 'POST', {
+      body: pickDefined(params),
+    });
+    return result;
+  }
+
+  /**
+   * Get a content block by id.
+   *
+   * @param {string} id
+   * @returns {Promise<Object>} Block
+   */
+  async get(id) {
+    this.sdk.validateParams(
+      { id },
+      { id: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(
+      this.sdk,
+      `/content/blocks/${id}`,
+      'GET',
+      {},
+    );
+    return result;
+  }
+
+  /**
+   * Update a content block. Only defined fields are sent.
+   *
+   * @param {string} id
+   * @param {Object} params
+   * @returns {Promise<Object>} Updated block
+   */
+  async update(id, params = {}) {
+    this.sdk.validateParams(
+      { id },
+      { id: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(this.sdk, `/content/blocks/${id}`, 'PUT', {
+      body: pickDefined(params),
+    });
+    return result;
+  }
+
+  /**
+   * Delete a content block.
+   *
+   * @param {string} id
+   * @returns {Promise<Object>} Confirmation
+   */
+  async delete(id) {
+    this.sdk.validateParams(
+      { id },
+      { id: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(
+      this.sdk,
+      `/content/blocks/${id}`,
+      'DELETE',
+      {},
+    );
+    return result;
+  }
+}
+
+/**
+ * Platform template library. `sdk.content.library.*`.
+ * No `/use` route exists yet — list / get / create only.
+ */
+export class ContentLibraryService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * List library templates.
+   *
+   * @param {Object} [filters]
+   * @param {string} [filters.channel]
+   * @param {string} [filters.category]
+   * @param {string} [filters.appearance] - `client` or `marketing`
+   * @param {boolean} [filters.isPublished]
+   * @param {number} [filters.limit]
+   * @returns {Promise<Object>} `{ results }`
+   */
+  async list({ channel, category, appearance, isPublished, limit } = {}) {
+    const query = pickDefined({
+      channel,
+      category,
+      appearance,
+      isPublished,
+      limit,
+    });
+    const options = Object.keys(query).length ? { query } : {};
+    const result = await internalRequest(
+      this.sdk,
+      '/content/library',
+      'GET',
+      options,
+    );
+    return result;
+  }
+
+  /**
+   * Get a library template by id.
+   *
+   * @param {string} id
+   * @returns {Promise<Object>} Library item
+   */
+  async get(id) {
+    this.sdk.validateParams(
+      { id },
+      { id: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(
+      this.sdk,
+      `/content/library/${id}`,
+      'GET',
+      {},
+    );
+    return result;
+  }
+
+  /**
+   * Create a library template.
+   *
+   * @param {Object} params
+   * @param {string} params.name - Name (required)
+   * @returns {Promise<Object>} Created item
+   */
+  async create(params = {}) {
+    this.sdk.validateParams(
+      { name: params.name },
+      { name: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(this.sdk, '/content/library', 'POST', {
+      body: pickDefined(params),
+    });
+    return result;
+  }
+}
+
+/**
+ * Stock / GIF search + import-to-storage. `sdk.content.stock.*`.
+ */
+export class ContentStockService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * Search Unsplash.
+   *
+   * @param {Object} [params]
+   * @param {string} [params.q]
+   * @param {number} [params.page]
+   * @returns {Promise<Object>} `{ items }`
+   */
+  async searchUnsplash({ q, page } = {}) {
+    return this._search('unsplash', { q, page });
+  }
+
+  /**
+   * Search Pexels.
+   *
+   * @param {Object} [params]
+   * @param {string} [params.q]
+   * @param {number} [params.page]
+   * @returns {Promise<Object>} `{ items }`
+   */
+  async searchPexels({ q, page } = {}) {
+    return this._search('pexels', { q, page });
+  }
+
+  /**
+   * Search GIPHY.
+   *
+   * @param {Object} [params]
+   * @param {string} [params.q]
+   * @param {number} [params.page]
+   * @returns {Promise<Object>} `{ items }`
+   */
+  async searchGiphy({ q, page } = {}) {
+    return this._search('giphy', { q, page });
+  }
+
+  /**
+   * Import a stock asset into account storage.
+   *
+   * @param {Object} params
+   * @param {string} params.source - `unsplash` | `pexels` | `giphy`
+   * @param {string} [params.remoteId]
+   * @param {string} [params.url]
+   * @returns {Promise<Object>} `{ storageId, url }`
+   */
+  async import(params = {}) {
+    this.sdk.validateParams(
+      { source: params.source },
+      { source: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(
+      this.sdk,
+      '/content/stock/import',
+      'POST',
+      { body: pickDefined(params) },
+    );
+    return result;
+  }
+
+  async _search(source, { q, page } = {}) {
+    const query = pickDefined({ q, page });
+    const options = Object.keys(query).length ? { query } : {};
+    return internalRequest(
+      this.sdk,
+      `/content/stock/${source}`,
+      'GET',
+      options,
+    );
+  }
+}

package/services/messaging/EmailTemplatesService.js

@@ -1,4 +1,13 @@
 import { internalRequest } from '../../base.js';
+
+function pickDefined(fields) {
+  const body = {};
+  for (const [key, value] of Object.entries(fields)) {
+    if (value !== undefined) body[key] = value;
+  }
+  return body;
+}
+
 export class EmailTemplatesService {
   constructor(sdk) {
     this.sdk = sdk;
@@ -11,6 +20,12 @@ export class EmailTemplatesService {
    * @param {string} params.subject - Template subject (required)
    * @param {string} [params.html] - HTML template body
    * @param {string} [params.text] - Plain text template body
+   * @param {Object} [params.design] - Block-tree design JSON (compiled server-side)
+   * @param {string} [params.appearance] - `client` or `marketing` (immutable after create)
+   * @param {boolean} [params.allowOneOff] - Usable as a one-off / compose send
+   * @param {boolean} [params.allowCampaign] - Usable in campaigns / journeys
+   * @param {string} [params.brandKitId] - Brand kit to apply
+   * @param {string} [params.category] - Template category
    * @param {Array<Object>} [params.variables] - Variable metadata definitions
    * @param {string} params.variables[].key - Variable key (unique, alphanumeric + underscores)
    * @param {string} params.variables[].label - Human-readable display name
@@ -22,6 +37,10 @@ export class EmailTemplatesService {
    * const template = await sdk.messaging.email.templates.create({
    *   name: 'Welcome Email',
    *   subject: 'Welcome {{firstName}}!',
+   *   appearance: 'marketing',
+   *   allowOneOff: true,
+   *   allowCampaign: true,
+   *   design: { type: 'email', children: [] },
    *   html: '<h1>Hello {{firstName}}</h1><p>{{body}}</p>',
    *   text: 'Hello {{firstName}}',
    *   variables: [
@@ -30,7 +49,19 @@ export class EmailTemplatesService {
    *   ],
    * });
    */
-  async create({ name, subject, html, text, variables }) {
+  async create({
+    name,
+    subject,
+    html,
+    text,
+    variables,
+    design,
+    appearance,
+    allowOneOff,
+    allowCampaign,
+    brandKitId,
+    category,
+  }) {
     this.sdk.validateParams(
       { name, subject },
       {
@@ -39,16 +70,29 @@ export class EmailTemplatesService {
         html: { type: 'string', required: false },
         text: { type: 'string', required: false },
         variables: { type: 'array', required: false },
+        design: { type: 'object', required: false },
+        appearance: { type: 'string', required: false },
+        allowOneOff: { type: 'boolean', required: false },
+        allowCampaign: { type: 'boolean', required: false },
+        brandKitId: { type: 'string', required: false },
+        category: { type: 'string', required: false },
       },
     );
 
-    const templateData = { name, subject };
-    if (html) templateData.html = html;
-    if (text) templateData.text = text;
-    if (variables) templateData.variables = variables;
-
     const options = {
-      body: templateData,
+      body: pickDefined({
+        name,
+        subject,
+        html,
+        text,
+        variables,
+        design,
+        appearance,
+        allowOneOff,
+        allowCampaign,
+        brandKitId,
+        category,
+      }),
     };
 
     const result = await internalRequest(this.sdk, 
@@ -60,13 +104,20 @@ export class EmailTemplatesService {
   }
 
   /**
-   * Update email template
+   * Update email template. Only defined fields are sent. Appearance is
+   * immutable after create and should usually be omitted.
    * @param {string} id - Template ID (required)
    * @param {Object} params - Update parameters
    * @param {string} [params.name] - Template name
    * @param {string} [params.subject] - Template subject
    * @param {string} [params.html] - HTML template body
    * @param {string} [params.text] - Plain text template body
+   * @param {Object} [params.design] - Block-tree design JSON (compiled server-side)
+   * @param {string} [params.appearance] - Usually omit; immutable after create
+   * @param {boolean} [params.allowOneOff] - Usable as a one-off / compose send
+   * @param {boolean} [params.allowCampaign] - Usable in campaigns / journeys
+   * @param {string} [params.brandKitId] - Brand kit to apply
+   * @param {string} [params.category] - Template category
    * @param {Array<Object>} [params.variables] - Variable metadata definitions
    * @param {string} params.variables[].key - Variable key (unique, alphanumeric + underscores)
    * @param {string} params.variables[].label - Human-readable display name
@@ -77,13 +128,31 @@ export class EmailTemplatesService {
    * @example
    * const updated = await sdk.messaging.email.templates.update('tpl_123', {
    *   subject: 'Hi {{firstName}}, welcome to {{companyName}}!',
+   *   allowOneOff: true,
+   *   allowCampaign: false,
+   *   design: { type: 'email', children: [] },
    *   variables: [
    *     { key: 'firstName', label: 'First Name', type: 'text', required: true },
    *     { key: 'companyName', label: 'Company Name', type: 'text' },
    *   ],
    * });
    */
-  async update(id, { name, subject, html, text, variables }) {
+  async update(
+    id,
+    {
+      name,
+      subject,
+      html,
+      text,
+      variables,
+      design,
+      appearance,
+      allowOneOff,
+      allowCampaign,
+      brandKitId,
+      category,
+    },
+  ) {
     this.sdk.validateParams(
       { id },
       {
@@ -93,18 +162,29 @@ export class EmailTemplatesService {
         html: { type: 'string', required: false },
         text: { type: 'string', required: false },
         variables: { type: 'array', required: false },
+        design: { type: 'object', required: false },
+        appearance: { type: 'string', required: false },
+        allowOneOff: { type: 'boolean', required: false },
+        allowCampaign: { type: 'boolean', required: false },
+        brandKitId: { type: 'string', required: false },
+        category: { type: 'string', required: false },
       },
     );
 
-    const updateData = {};
-    if (name) updateData.name = name;
-    if (subject) updateData.subject = subject;
-    if (html) updateData.html = html;
-    if (text) updateData.text = text;
-    if (variables) updateData.variables = variables;
-
     const options = {
-      body: updateData,
+      body: pickDefined({
+        name,
+        subject,
+        html,
+        text,
+        variables,
+        design,
+        appearance,
+        allowOneOff,
+        allowCampaign,
+        brandKitId,
+        category,
+      }),
     };
 
     const result = await internalRequest(this.sdk, 
@@ -156,11 +236,22 @@ export class EmailTemplatesService {
   }
 
   /**
-   * List all email templates
+   * List email templates, optionally filtered by appearance / usage flags.
+   * @param {Object} [filters]
+   * @param {string} [filters.appearance] - `client` or `marketing`
+   * @param {boolean} [filters.allowOneOff]
+   * @param {boolean} [filters.allowCampaign]
    * @returns {Promise<Array>} List of email templates
    */
-  async list() {
-    const result = await internalRequest(this.sdk, '/messaging/email/template', 'GET');
+  async list({ appearance, allowOneOff, allowCampaign } = {}) {
+    const query = pickDefined({ appearance, allowOneOff, allowCampaign });
+    const options = Object.keys(query).length ? { query } : {};
+    const result = await internalRequest(
+      this.sdk,
+      '/messaging/email/template',
+      'GET',
+      options,
+    );
     return result;
   }
 
@@ -173,13 +264,15 @@ export class EmailTemplatesService {
    * @param {string} [body.html] - Draft HTML body
    * @param {string} [body.text] - Draft plain-text body
    * @param {Object} [body.variables] - Variable substitution values
-   * @returns {Promise<Object>} Rendered preview
+   * @returns {Promise<Object>} Rendered preview. May include `unresolvedTags`
+   *   (string[]) for merge tags that were not substituted.
    * @example
    * const preview = await sdk.messaging.email.templates.preview('tpl_123', {
    *   subject: 'Welcome {{firstName}}',
    *   html: '<p>Hello {{firstName}}</p>',
    *   variables: { firstName: 'Jane' },
    * });
+   * // preview.unresolvedTags → [] or ['companyName', ...]
    */
   async preview(id, { subject, html, text, variables } = {}) {
     this.sdk.validateParams(
@@ -240,4 +333,72 @@ export class EmailTemplatesService {
     );
     return result;
   }
+
+  /**
+   * Autosave a draft design tree without compiling or snapshotting a version.
+   * @param {string} id - Template ID (required)
+   * @param {Object} body
+   * @param {Object} body.design - Block-tree design JSON (required)
+   * @returns {Promise<Object>} `{ id, draftDesignStorageId }`
+   */
+  async autosave(id, { design } = {}) {
+    this.sdk.validateParams(
+      { id, design },
+      {
+        id: { type: 'string', required: true },
+        design: { type: 'object', required: true },
+      },
+    );
+
+    const result = await internalRequest(this.sdk, 
+      `/messaging/email/template/${id}/autosave`,
+      'POST',
+      { body: { design } },
+    );
+    return result;
+  }
+
+  /**
+   * List saved versions of a template.
+   * @param {string} id - Template ID (required)
+   * @returns {Promise<Array>} Version rows
+   */
+  async listVersions(id) {
+    this.sdk.validateParams(
+      { id },
+      {
+        id: { type: 'string', required: true },
+      },
+    );
+
+    const result = await internalRequest(this.sdk, 
+      `/messaging/email/template/${id}/versions`,
+      'GET',
+    );
+    return result;
+  }
+
+  /**
+   * Restore a previously saved version as the current template.
+   * @param {string} id - Template ID (required)
+   * @param {number|string} version - Version number (required)
+   * @returns {Promise<Object>} Restored template
+   */
+  async restoreVersion(id, version) {
+    this.sdk.validateParams(
+      { id },
+      {
+        id: { type: 'string', required: true },
+      },
+    );
+    if (version === undefined || version === null || version === '') {
+      throw new Error('Missing required parameter version');
+    }
+
+    const result = await internalRequest(this.sdk, 
+      `/messaging/email/template/${id}/versions/${version}/restore`,
+      'POST',
+    );
+    return result;
+  }
 }