telnyx 7.22.0 → 7.24.0

package/resources/email-messages/recipients.d.mts

@@ -62,7 +62,7 @@ export interface EmailRecipient {
     /**
      * Current per-recipient delivery status.
      */
-    status: 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled';
+    status: 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled' | 'injection_timeout' | 'expired';
     delivered_at?: string | null;
     failed_at?: string | null;
     sent_at?: string | null;
@@ -86,7 +86,7 @@ export interface RecipientListParams extends EmailCursorPaginationParams {
     /**
      * Filter recipients by status.
      */
-    status?: 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled';
+    status?: 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled' | 'injection_timeout' | 'expired';
 }
 export interface RecipientRetrieveParams {
     /**

package/resources/email-messages/recipients.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"recipients.d.mts","sourceRoot":"","sources":["../../src/resources/email-messages/recipients.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,qBAAqB,EAAE,KAAK,2BAA2B,EAAE,WAAW,EAAE,kCAA8B;AAC7G,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,oCAAoC,EAAE,cAAc,CAAC;IAQpE;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,yBAAyB,CAAC;CAIzC;AAED,MAAM,MAAM,oCAAoC,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAC;AAEzF,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAE1B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,iBAAiB,CAAC;IAE/B;;OAEG;IACH,MAAM,EACF,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,CAAC;IAEhB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,2BAA2B;IACtE;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAE3B;;OAEG;IACH,MAAM,CAAC,EACH,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,oCAAoC,IAAI,oCAAoC,EACjF,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}
+{"version":3,"file":"recipients.d.mts","sourceRoot":"","sources":["../../src/resources/email-messages/recipients.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,qBAAqB,EAAE,KAAK,2BAA2B,EAAE,WAAW,EAAE,kCAA8B;AAC7G,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,oCAAoC,EAAE,cAAc,CAAC;IAQpE;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,yBAAyB,CAAC;CAIzC;AAED,MAAM,MAAM,oCAAoC,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAC;AAEzF,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAE1B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,iBAAiB,CAAC;IAE/B;;OAEG;IACH,MAAM,EACF,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,GACX,mBAAmB,GACnB,SAAS,CAAC;IAEd,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,2BAA2B;IACtE;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAE3B;;OAEG;IACH,MAAM,CAAC,EACH,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,GACX,mBAAmB,GACnB,SAAS,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,oCAAoC,IAAI,oCAAoC,EACjF,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}

package/resources/email-messages/recipients.d.ts

@@ -62,7 +62,7 @@ export interface EmailRecipient {
     /**
      * Current per-recipient delivery status.
      */
-    status: 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled';
+    status: 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled' | 'injection_timeout' | 'expired';
     delivered_at?: string | null;
     failed_at?: string | null;
     sent_at?: string | null;
@@ -86,7 +86,7 @@ export interface RecipientListParams extends EmailCursorPaginationParams {
     /**
      * Filter recipients by status.
      */
-    status?: 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled';
+    status?: 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled' | 'injection_timeout' | 'expired';
 }
 export interface RecipientRetrieveParams {
     /**

package/resources/email-messages/recipients.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipients.d.ts","sourceRoot":"","sources":["../../src/resources/email-messages/recipients.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,qBAAqB,EAAE,KAAK,2BAA2B,EAAE,WAAW,EAAE,iCAA8B;AAC7G,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,oCAAoC,EAAE,cAAc,CAAC;IAQpE;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,yBAAyB,CAAC;CAIzC;AAED,MAAM,MAAM,oCAAoC,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAC;AAEzF,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAE1B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,iBAAiB,CAAC;IAE/B;;OAEG;IACH,MAAM,EACF,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,CAAC;IAEhB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,2BAA2B;IACtE;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAE3B;;OAEG;IACH,MAAM,CAAC,EACH,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,oCAAoC,IAAI,oCAAoC,EACjF,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}
+{"version":3,"file":"recipients.d.ts","sourceRoot":"","sources":["../../src/resources/email-messages/recipients.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,qBAAqB,EAAE,KAAK,2BAA2B,EAAE,WAAW,EAAE,iCAA8B;AAC7G,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,oCAAoC,EAAE,cAAc,CAAC;IAQpE;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,yBAAyB,CAAC;CAIzC;AAED,MAAM,MAAM,oCAAoC,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAC;AAEzF,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAE1B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,iBAAiB,CAAC;IAE/B;;OAEG;IACH,MAAM,EACF,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,GACX,mBAAmB,GACnB,SAAS,CAAC;IAEd,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,2BAA2B;IACtE;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAE3B;;OAEG;IACH,MAAM,CAAC,EACH,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,GACX,mBAAmB,GACnB,SAAS,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,oCAAoC,IAAI,oCAAoC,EACjF,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}

package/resources/email-templates.d.mts

@@ -91,6 +91,12 @@ export declare class EmailTemplates extends APIResource {
      * Renders a template using the provided Liquid variables. Missing
      * `template_variables` defaults to `{}`.
      *
+     * When the template has `strict_variables` enabled and a required variable (per
+     * `variable_schema`) is missing, returns 422 naming the variable. When the
+     * template has `autoescape` enabled, the rendered `html_body` expression output is
+     * HTML-escaped at the output boundary; `subject` and `text_body` are not
+     * autoescaped.
+     *
      * @example
      * ```ts
      * const response = await client.emailTemplates.render(
@@ -104,24 +110,67 @@ export declare class EmailTemplates extends APIResource {
 export type EmailTemplatesEmailCursorPagination = EmailCursorPagination<EmailTemplate>;
 export interface EmailTemplate {
     id: string;
+    /**
+     * Whether HTML autoescaping is enabled for this template. When `true`, only
+     * rendered `html_body` expression output is HTML-escaped at the output boundary;
+     * `subject` and `text_body` are never autoescaped.
+     */
+    autoescape: boolean;
     created_at: string;
     html_body: string | null;
     name: string;
     record_type: 'email_template';
+    /**
+     * Whether strict variable validation is enabled for this template. When `true`,
+     * sends and renders that are missing a variable marked `required: true` in
+     * `variable_schema` fail with 422 naming the variable.
+     */
+    strict_variables: boolean;
     subject: string | null;
     text_body: string | null;
     updated_at: string;
+    /**
+     * Structured variable requirements, or `null` when the template uses only the
+     * legacy `variables` array.
+     */
+    variable_schema: {
+        [key: string]: EmailTemplate.VariableSchema;
+    } | null;
+    /**
+     * Legacy unstructured variable names. This path remains supported unchanged.
+     */
     variables: Array<string>;
 }
+export declare namespace EmailTemplate {
+    interface VariableSchema {
+        /**
+         * Whether the variable must be supplied when strict variable validation is
+         * enabled.
+         */
+        required: boolean;
+        /**
+         * Default value for an optional variable. Rejected when `required` is `true`.
+         */
+        default?: string;
+    }
+}
 export interface EmailTemplateResponse {
     data: EmailTemplate;
 }
 export interface UpdateEmailTemplateRequest {
+    /**
+     * Per-template HTML autoescaping setting.
+     */
+    autoescape?: boolean;
     /**
      * Liquid template HTML body.
      */
     html_body?: string | null;
     name?: string;
+    /**
+     * Per-template strict variable-validation setting.
+     */
+    strict_variables?: boolean;
     /**
      * Liquid template subject.
      */
@@ -130,8 +179,28 @@ export interface UpdateEmailTemplateRequest {
      * Liquid template text body.
      */
     text_body?: string | null;
+    /**
+     * Structured variable requirements. Required variables cannot define defaults;
+     * invalid combinations return 422. Set to `null` to clear the schema.
+     */
+    variable_schema?: {
+        [key: string]: UpdateEmailTemplateRequest.VariableSchema;
+    } | null;
     variables?: Array<string>;
 }
+export declare namespace UpdateEmailTemplateRequest {
+    interface VariableSchema {
+        /**
+         * Whether the variable must be supplied when strict variable validation is
+         * enabled.
+         */
+        required: boolean;
+        /**
+         * Default value for an optional variable. Rejected when `required` is `true`.
+         */
+        default?: string;
+    }
+}
 export interface EmailTemplateRenderResponse {
     /**
      * Template object with `subject`, `html_body`, and `text_body` replaced by their
@@ -156,10 +225,30 @@ export interface EmailTemplateCreateParams {
      * Body param: Letters, numbers, spaces, hyphens, and underscores only.
      */
     name: string;
+    /**
+     * Body param: Per-template HTML autoescaping setting. Defaults to `false` for
+     * backward compatibility. When `true`, the rendered `html_body` HTML-escapes each
+     * Liquid expression's output at the output boundary (after its filters run, before
+     * concatenation with literal template markup). Input values are never mutated and
+     * `subject`/`text_body` are never autoescaped. The boundary escape is idempotent:
+     * HTML entities already present in the output (e.g. from an explicit `escape`
+     * filter) are preserved, so an explicit `escape`/`escape_once` is never
+     * double-escaped, and markup introduced by any later filter in the chain is still
+     * escaped.
+     */
+    autoescape?: boolean;
     /**
      * Body param: Liquid template HTML body.
      */
     html_body?: string | null;
+    /**
+     * Body param: Per-template strict variable-validation setting. Defaults to `false`
+     * for backward compatibility. When `true`, a send or render that is missing a
+     * variable marked `required: true` in `variable_schema` fails with 422 naming the
+     * variable. Missing optional variables never fail; their schema `default` (when
+     * set) is applied to the render.
+     */
+    strict_variables?: boolean;
     /**
      * Body param: Liquid template subject.
      */
@@ -168,6 +257,18 @@ export interface EmailTemplateCreateParams {
      * Body param: Liquid template text body.
      */
     text_body?: string | null;
+    /**
+     * Body param: Structured variable requirements. Required variables cannot define
+     * defaults; invalid combinations return 422. This is independent of the legacy
+     * `variables` array. On render with `strict_variables` enabled: `required`
+     * variables must be supplied as non-empty values — absent, `null`, empty string,
+     * empty object `{}`, and empty array `[]` all fail with 422 naming the variable,
+     * while present values such as `false` and `0` pass (they are present, not empty).
+     * Optional variables fall back to their `default` when absent.
+     */
+    variable_schema?: {
+        [key: string]: EmailTemplateCreateParams.VariableSchema;
+    } | null;
     /**
      * Body param: Template variables. Auto-extracted from subject/body fields when
      * absent.
@@ -185,12 +286,33 @@ export interface EmailTemplateCreateParams {
      */
     'Idempotency-Key'?: string;
 }
+export declare namespace EmailTemplateCreateParams {
+    interface VariableSchema {
+        /**
+         * Whether the variable must be supplied when strict variable validation is
+         * enabled.
+         */
+        required: boolean;
+        /**
+         * Default value for an optional variable. Rejected when `required` is `true`.
+         */
+        default?: string;
+    }
+}
 export interface EmailTemplateReplaceParams {
+    /**
+     * Per-template HTML autoescaping setting.
+     */
+    autoescape?: boolean;
     /**
      * Liquid template HTML body.
      */
     html_body?: string | null;
     name?: string;
+    /**
+     * Per-template strict variable-validation setting.
+     */
+    strict_variables?: boolean;
     /**
      * Liquid template subject.
      */
@@ -199,14 +321,42 @@ export interface EmailTemplateReplaceParams {
      * Liquid template text body.
      */
     text_body?: string | null;
+    /**
+     * Structured variable requirements. Required variables cannot define defaults;
+     * invalid combinations return 422. Set to `null` to clear the schema.
+     */
+    variable_schema?: {
+        [key: string]: EmailTemplateReplaceParams.VariableSchema;
+    } | null;
     variables?: Array<string>;
 }
+export declare namespace EmailTemplateReplaceParams {
+    interface VariableSchema {
+        /**
+         * Whether the variable must be supplied when strict variable validation is
+         * enabled.
+         */
+        required: boolean;
+        /**
+         * Default value for an optional variable. Rejected when `required` is `true`.
+         */
+        default?: string;
+    }
+}
 export interface EmailTemplateUpdateParams {
+    /**
+     * Per-template HTML autoescaping setting.
+     */
+    autoescape?: boolean;
     /**
      * Liquid template HTML body.
      */
     html_body?: string | null;
     name?: string;
+    /**
+     * Per-template strict variable-validation setting.
+     */
+    strict_variables?: boolean;
     /**
      * Liquid template subject.
      */
@@ -215,8 +365,28 @@ export interface EmailTemplateUpdateParams {
      * Liquid template text body.
      */
     text_body?: string | null;
+    /**
+     * Structured variable requirements. Required variables cannot define defaults;
+     * invalid combinations return 422. Set to `null` to clear the schema.
+     */
+    variable_schema?: {
+        [key: string]: EmailTemplateUpdateParams.VariableSchema;
+    } | null;
     variables?: Array<string>;
 }
+export declare namespace EmailTemplateUpdateParams {
+    interface VariableSchema {
+        /**
+         * Whether the variable must be supplied when strict variable validation is
+         * enabled.
+         */
+        required: boolean;
+        /**
+         * Default value for an optional variable. Rejected when `required` is `true`.
+         */
+        default?: string;
+    }
+}
 export interface EmailTemplateRenderParams {
     /**
      * Variables for Liquid template rendering. Non-object values are silently treated

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

@@ -1 +1 @@
-{"version":3,"file":"email-templates.d.mts","sourceRoot":"","sources":["../src/resources/email-templates.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,KAAK,iBAAiB,8BAA0B;AACvD,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,qBAAqB,EAAE,KAAK,2BAA2B,EAAE,WAAW,EAAE,+BAA2B;AAE1G,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAG7D;;GAEG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C;;;;;;;;;;OAUG;IACH,IAAI,CACF,KAAK,GAAE,uBAAuB,GAAG,IAAI,GAAG,SAAc,EACtD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,mCAAmC,EAAE,aAAa,CAAC;IAOlE;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,MAAM,EAAE,yBAAyB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;IAYtG;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAO9D;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;IAIjF;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,0BAA0B,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAIpC;;;;;;;;;;;;OAYG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,yBAAyB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAIpC;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,yBAAyB,GAAG,IAAI,GAAG,SAAc,EACvD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,2BAA2B,CAAC;CAG3C;AAED,MAAM,MAAM,mCAAmC,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;AAEvF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IAEX,UAAU,EAAE,MAAM,CAAC;IAEnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,EAAE,gBAAgB,CAAC;IAE9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,UAAU,EAAE,MAAM,CAAC;IAEnB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,IAAI,EAAE,2BAA2B,CAAC,IAAI,CAAC;CACxC;AAED,yBAAiB,2BAA2B,CAAC;IAC3C;;;;OAIG;IACH,UAAiB,IAAK,SAAQ,iBAAiB,CAAC,aAAa;KAAG;CACjE;AAED,MAAM,WAAW,uBAAwB,SAAQ,2BAA2B;CAAG;AAE/E,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1B;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,kBAAkB,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACjD;AAED,MAAM,CAAC,OAAO,WAAW,cAAc,CAAC;IACtC,OAAO,EACL,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,mCAAmC,IAAI,mCAAmC,EAC/E,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,yBAAyB,IAAI,yBAAyB,GAC5D,CAAC;CACH"}
+{"version":3,"file":"email-templates.d.mts","sourceRoot":"","sources":["../src/resources/email-templates.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,KAAK,iBAAiB,8BAA0B;AACvD,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,qBAAqB,EAAE,KAAK,2BAA2B,EAAE,WAAW,EAAE,+BAA2B;AAE1G,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAG7D;;GAEG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C;;;;;;;;;;OAUG;IACH,IAAI,CACF,KAAK,GAAE,uBAAuB,GAAG,IAAI,GAAG,SAAc,EACtD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,mCAAmC,EAAE,aAAa,CAAC;IAOlE;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,MAAM,EAAE,yBAAyB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;IAYtG;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAO9D;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;IAIjF;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,0BAA0B,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAIpC;;;;;;;;;;;;OAYG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,yBAAyB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAIpC;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,yBAAyB,GAAG,IAAI,GAAG,SAAc,EACvD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,2BAA2B,CAAC;CAG3C;AAED,MAAM,MAAM,mCAAmC,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;AAEvF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IAEX;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB,UAAU,EAAE,MAAM,CAAC;IAEnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,EAAE,gBAAgB,CAAC;IAE9B;;;;OAIG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,eAAe,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC,cAAc,CAAA;KAAE,GAAG,IAAI,CAAC;IAExE;;OAEG;IACH,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED,yBAAiB,aAAa,CAAC;IAC7B,UAAiB,cAAc;QAC7B;;;WAGG;QACH,QAAQ,EAAE,OAAO,CAAC;QAElB;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,eAAe,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,0BAA0B,CAAC,cAAc,CAAA;KAAE,GAAG,IAAI,CAAC;IAEtF,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,yBAAiB,0BAA0B,CAAC;IAC1C,UAAiB,cAAc;QAC7B;;;WAGG;QACH,QAAQ,EAAE,OAAO,CAAC;QAElB;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,IAAI,EAAE,2BAA2B,CAAC,IAAI,CAAC;CACxC;AAED,yBAAiB,2BAA2B,CAAC;IAC3C;;;;OAIG;IACH,UAAiB,IAAK,SAAQ,iBAAiB,CAAC,aAAa;KAAG;CACjE;AAED,MAAM,WAAW,uBAAwB,SAAQ,2BAA2B;CAAG;AAE/E,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,CAAC,cAAc,CAAA;KAAE,GAAG,IAAI,CAAC;IAErF;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1B;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,yBAAiB,yBAAyB,CAAC;IACzC,UAAiB,cAAc;QAC7B;;;WAGG;QACH,QAAQ,EAAE,OAAO,CAAC;QAElB;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,eAAe,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,0BAA0B,CAAC,cAAc,CAAA;KAAE,GAAG,IAAI,CAAC;IAEtF,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,yBAAiB,0BAA0B,CAAC;IAC1C,UAAiB,cAAc;QAC7B;;;WAGG;QACH,QAAQ,EAAE,OAAO,CAAC;QAElB;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,eAAe,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,CAAC,cAAc,CAAA;KAAE,GAAG,IAAI,CAAC;IAErF,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,yBAAiB,yBAAyB,CAAC;IACzC,UAAiB,cAAc;QAC7B;;;WAGG;QACH,QAAQ,EAAE,OAAO,CAAC;QAElB;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,kBAAkB,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACjD;AAED,MAAM,CAAC,OAAO,WAAW,cAAc,CAAC;IACtC,OAAO,EACL,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,mCAAmC,IAAI,mCAAmC,EAC/E,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,yBAAyB,IAAI,yBAAyB,GAC5D,CAAC;CACH"}

package/resources/email-templates.d.ts

@@ -91,6 +91,12 @@ export declare class EmailTemplates extends APIResource {
      * Renders a template using the provided Liquid variables. Missing
      * `template_variables` defaults to `{}`.
      *
+     * When the template has `strict_variables` enabled and a required variable (per
+     * `variable_schema`) is missing, returns 422 naming the variable. When the
+     * template has `autoescape` enabled, the rendered `html_body` expression output is
+     * HTML-escaped at the output boundary; `subject` and `text_body` are not
+     * autoescaped.
+     *
      * @example
      * ```ts
      * const response = await client.emailTemplates.render(
@@ -104,24 +110,67 @@ export declare class EmailTemplates extends APIResource {
 export type EmailTemplatesEmailCursorPagination = EmailCursorPagination<EmailTemplate>;
 export interface EmailTemplate {
     id: string;
+    /**
+     * Whether HTML autoescaping is enabled for this template. When `true`, only
+     * rendered `html_body` expression output is HTML-escaped at the output boundary;
+     * `subject` and `text_body` are never autoescaped.
+     */
+    autoescape: boolean;
     created_at: string;
     html_body: string | null;
     name: string;
     record_type: 'email_template';
+    /**
+     * Whether strict variable validation is enabled for this template. When `true`,
+     * sends and renders that are missing a variable marked `required: true` in
+     * `variable_schema` fail with 422 naming the variable.
+     */
+    strict_variables: boolean;
     subject: string | null;
     text_body: string | null;
     updated_at: string;
+    /**
+     * Structured variable requirements, or `null` when the template uses only the
+     * legacy `variables` array.
+     */
+    variable_schema: {
+        [key: string]: EmailTemplate.VariableSchema;
+    } | null;
+    /**
+     * Legacy unstructured variable names. This path remains supported unchanged.
+     */
     variables: Array<string>;
 }
+export declare namespace EmailTemplate {
+    interface VariableSchema {
+        /**
+         * Whether the variable must be supplied when strict variable validation is
+         * enabled.
+         */
+        required: boolean;
+        /**
+         * Default value for an optional variable. Rejected when `required` is `true`.
+         */
+        default?: string;
+    }
+}
 export interface EmailTemplateResponse {
     data: EmailTemplate;
 }
 export interface UpdateEmailTemplateRequest {
+    /**
+     * Per-template HTML autoescaping setting.
+     */
+    autoescape?: boolean;
     /**
      * Liquid template HTML body.
      */
     html_body?: string | null;
     name?: string;
+    /**
+     * Per-template strict variable-validation setting.
+     */
+    strict_variables?: boolean;
     /**
      * Liquid template subject.
      */
@@ -130,8 +179,28 @@ export interface UpdateEmailTemplateRequest {
      * Liquid template text body.
      */
     text_body?: string | null;
+    /**
+     * Structured variable requirements. Required variables cannot define defaults;
+     * invalid combinations return 422. Set to `null` to clear the schema.
+     */
+    variable_schema?: {
+        [key: string]: UpdateEmailTemplateRequest.VariableSchema;
+    } | null;
     variables?: Array<string>;
 }
+export declare namespace UpdateEmailTemplateRequest {
+    interface VariableSchema {
+        /**
+         * Whether the variable must be supplied when strict variable validation is
+         * enabled.
+         */
+        required: boolean;
+        /**
+         * Default value for an optional variable. Rejected when `required` is `true`.
+         */
+        default?: string;
+    }
+}
 export interface EmailTemplateRenderResponse {
     /**
      * Template object with `subject`, `html_body`, and `text_body` replaced by their
@@ -156,10 +225,30 @@ export interface EmailTemplateCreateParams {
      * Body param: Letters, numbers, spaces, hyphens, and underscores only.
      */
     name: string;
+    /**
+     * Body param: Per-template HTML autoescaping setting. Defaults to `false` for
+     * backward compatibility. When `true`, the rendered `html_body` HTML-escapes each
+     * Liquid expression's output at the output boundary (after its filters run, before
+     * concatenation with literal template markup). Input values are never mutated and
+     * `subject`/`text_body` are never autoescaped. The boundary escape is idempotent:
+     * HTML entities already present in the output (e.g. from an explicit `escape`
+     * filter) are preserved, so an explicit `escape`/`escape_once` is never
+     * double-escaped, and markup introduced by any later filter in the chain is still
+     * escaped.
+     */
+    autoescape?: boolean;
     /**
      * Body param: Liquid template HTML body.
      */
     html_body?: string | null;
+    /**
+     * Body param: Per-template strict variable-validation setting. Defaults to `false`
+     * for backward compatibility. When `true`, a send or render that is missing a
+     * variable marked `required: true` in `variable_schema` fails with 422 naming the
+     * variable. Missing optional variables never fail; their schema `default` (when
+     * set) is applied to the render.
+     */
+    strict_variables?: boolean;
     /**
      * Body param: Liquid template subject.
      */
@@ -168,6 +257,18 @@ export interface EmailTemplateCreateParams {
      * Body param: Liquid template text body.
      */
     text_body?: string | null;
+    /**
+     * Body param: Structured variable requirements. Required variables cannot define
+     * defaults; invalid combinations return 422. This is independent of the legacy
+     * `variables` array. On render with `strict_variables` enabled: `required`
+     * variables must be supplied as non-empty values — absent, `null`, empty string,
+     * empty object `{}`, and empty array `[]` all fail with 422 naming the variable,
+     * while present values such as `false` and `0` pass (they are present, not empty).
+     * Optional variables fall back to their `default` when absent.
+     */
+    variable_schema?: {
+        [key: string]: EmailTemplateCreateParams.VariableSchema;
+    } | null;
     /**
      * Body param: Template variables. Auto-extracted from subject/body fields when
      * absent.
@@ -185,12 +286,33 @@ export interface EmailTemplateCreateParams {
      */
     'Idempotency-Key'?: string;
 }
+export declare namespace EmailTemplateCreateParams {
+    interface VariableSchema {
+        /**
+         * Whether the variable must be supplied when strict variable validation is
+         * enabled.
+         */
+        required: boolean;
+        /**
+         * Default value for an optional variable. Rejected when `required` is `true`.
+         */
+        default?: string;
+    }
+}
 export interface EmailTemplateReplaceParams {
+    /**
+     * Per-template HTML autoescaping setting.
+     */
+    autoescape?: boolean;
     /**
      * Liquid template HTML body.
      */
     html_body?: string | null;
     name?: string;
+    /**
+     * Per-template strict variable-validation setting.
+     */
+    strict_variables?: boolean;
     /**
      * Liquid template subject.
      */
@@ -199,14 +321,42 @@ export interface EmailTemplateReplaceParams {
      * Liquid template text body.
      */
     text_body?: string | null;
+    /**
+     * Structured variable requirements. Required variables cannot define defaults;
+     * invalid combinations return 422. Set to `null` to clear the schema.
+     */
+    variable_schema?: {
+        [key: string]: EmailTemplateReplaceParams.VariableSchema;
+    } | null;
     variables?: Array<string>;
 }
+export declare namespace EmailTemplateReplaceParams {
+    interface VariableSchema {
+        /**
+         * Whether the variable must be supplied when strict variable validation is
+         * enabled.
+         */
+        required: boolean;
+        /**
+         * Default value for an optional variable. Rejected when `required` is `true`.
+         */
+        default?: string;
+    }
+}
 export interface EmailTemplateUpdateParams {
+    /**
+     * Per-template HTML autoescaping setting.
+     */
+    autoescape?: boolean;
     /**
      * Liquid template HTML body.
      */
     html_body?: string | null;
     name?: string;
+    /**
+     * Per-template strict variable-validation setting.
+     */
+    strict_variables?: boolean;
     /**
      * Liquid template subject.
      */
@@ -215,8 +365,28 @@ export interface EmailTemplateUpdateParams {
      * Liquid template text body.
      */
     text_body?: string | null;
+    /**
+     * Structured variable requirements. Required variables cannot define defaults;
+     * invalid combinations return 422. Set to `null` to clear the schema.
+     */
+    variable_schema?: {
+        [key: string]: EmailTemplateUpdateParams.VariableSchema;
+    } | null;
     variables?: Array<string>;
 }
+export declare namespace EmailTemplateUpdateParams {
+    interface VariableSchema {
+        /**
+         * Whether the variable must be supplied when strict variable validation is
+         * enabled.
+         */
+        required: boolean;
+        /**
+         * Default value for an optional variable. Rejected when `required` is `true`.
+         */
+        default?: string;
+    }
+}
 export interface EmailTemplateRenderParams {
     /**
      * Variables for Liquid template rendering. Non-object values are silently treated

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

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

package/resources/email-templates.js

@@ -120,6 +120,12 @@ class EmailTemplates extends resource_1.APIResource {
      * Renders a template using the provided Liquid variables. Missing
      * `template_variables` defaults to `{}`.
      *
+     * When the template has `strict_variables` enabled and a required variable (per
+     * `variable_schema`) is missing, returns 422 naming the variable. When the
+     * template has `autoescape` enabled, the rendered `html_body` expression output is
+     * HTML-escaped at the output boundary; `subject` and `text_body` are not
+     * autoescaped.
+     *
      * @example
      * ```ts
      * const response = await client.emailTemplates.render(

package/resources/email-templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"email-templates.js","sourceRoot":"","sources":["../src/resources/email-templates.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,sDAA0G;AAC1G,oDAAmD;AAEnD,oDAA8C;AAE9C;;GAEG;AACH,MAAa,cAAe,SAAQ,sBAAW;IAC7C;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAAoD,EAAE,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAA,kCAAoC,CAAA,EAAE;YACvF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,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;;;;;;;;;;OAUG;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;;;;;;;;;;;OAWG;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;;;;;;;;;;;;OAYG;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;;;;;;;;;;;;OAYG;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;AA/ID,wCA+IC"}
+{"version":3,"file":"email-templates.js","sourceRoot":"","sources":["../src/resources/email-templates.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,sDAA0G;AAC1G,oDAAmD;AAEnD,oDAA8C;AAE9C;;GAEG;AACH,MAAa,cAAe,SAAQ,sBAAW;IAC7C;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAAoD,EAAE,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAA,kCAAoC,CAAA,EAAE;YACvF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,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;;;;;;;;;;OAUG;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;;;;;;;;;;;OAWG;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;;;;;;;;;;;;OAYG;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;;;;;;;;;;;;OAYG;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;;;;;;;;;;;;;;;;;OAiBG;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;AArJD,wCAqJC"}

package/resources/email-templates.mjs

@@ -117,6 +117,12 @@ export class EmailTemplates extends APIResource {
      * Renders a template using the provided Liquid variables. Missing
      * `template_variables` defaults to `{}`.
      *
+     * When the template has `strict_variables` enabled and a required variable (per
+     * `variable_schema`) is missing, returns 422 naming the variable. When the
+     * template has `autoescape` enabled, the rendered `html_body` expression output is
+     * HTML-escaped at the output boundary; `subject` and `text_body` are not
+     * autoescaped.
+     *
      * @example
      * ```ts
      * const response = await client.emailTemplates.render(