@sentdm/sentdm 0.25.4 → 0.26.0

package/src/resources/templates.ts

@@ -1,8 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
-import * as TemplatesAPI from './templates';
-import * as WebhooksAPI from './webhooks';
 import { APIPromise } from '../core/api-promise';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
@@ -19,10 +17,10 @@ export class Templates extends APIResource {
    *
    * @example
    * ```ts
-   * const apiResponseTemplate = await client.templates.create();
+   * const template = await client.templates.create();
    * ```
    */
-  create(params: TemplateCreateParams, options?: RequestOptions): APIPromise<APIResponseTemplate> {
+  create(params: TemplateCreateParams, options?: RequestOptions): APIPromise<TemplateCreateResponse> {
     const { 'Idempotency-Key': idempotencyKey, 'x-profile-id': xProfileID, ...body } = params;
     return this._client.post('/v3/templates', {
       body,
@@ -43,7 +41,7 @@ export class Templates extends APIResource {
    *
    * @example
    * ```ts
-   * const apiResponseTemplate = await client.templates.retrieve(
+   * const template = await client.templates.retrieve(
    *   '7ba7b820-9dad-11d1-80b4-00c04fd430c8',
    * );
    * ```
@@ -52,7 +50,7 @@ export class Templates extends APIResource {
     id: string,
     params: TemplateRetrieveParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<APIResponseTemplate> {
+  ): APIPromise<TemplateRetrieveResponse> {
     const { 'x-profile-id': xProfileID } = params ?? {};
     return this._client.get(path`/v3/templates/${id}`, {
       ...options,
@@ -69,7 +67,7 @@ export class Templates extends APIResource {
    *
    * @example
    * ```ts
-   * const apiResponseTemplate = await client.templates.update(
+   * const template = await client.templates.update(
    *   '7ba7b820-9dad-11d1-80b4-00c04fd430c8',
    * );
    * ```
@@ -78,7 +76,7 @@ export class Templates extends APIResource {
     id: string,
     params: TemplateUpdateParams,
     options?: RequestOptions,
-  ): APIPromise<APIResponseTemplate> {
+  ): APIPromise<TemplateUpdateResponse> {
     const { 'Idempotency-Key': idempotencyKey, 'x-profile-id': xProfileID, ...body } = params;
     return this._client.put(path`/v3/templates/${id}`, {
       body,
@@ -144,21 +142,21 @@ export class Templates extends APIResource {
 /**
  * Standard API response envelope for all v3 endpoints
  */
-export interface APIResponseTemplate {
+export interface TemplateCreateResponse {
   /**
    * Template response for v3 API
    */
-  data?: Template | null;
+  data?: TemplateCreateResponse.Data | null;
 
   /**
    * Error information
    */
-  error?: WebhooksAPI.ErrorDetail | null;
+  error?: TemplateCreateResponse.Error | null;
 
   /**
    * Request and response metadata
    */
-  meta?: WebhooksAPI.APIMeta;
+  meta?: TemplateCreateResponse.Meta;
 
   /**
    * Indicates whether the request was successful
@@ -166,256 +164,359 @@ export interface APIResponseTemplate {
   success?: boolean;
 }
 
-/**
- * Configuration for AUTHENTICATION category templates
- */
-export interface SentDmServicesCommonContractsPocOsAuthenticationConfig {
-  /**
-   * Whether to add the security recommendation text: "For your security, do not
-   * share this code."
-   */
-  addSecurityRecommendation?: boolean;
-
-  /**
-   * Code expiration time in minutes (1-90). If set, adds footer: "This code expires
-   * in X minutes."
-   */
-  codeExpirationMinutes?: number | null;
-}
-
-/**
- * Body section of a message template with channel-specific content
- */
-export interface SentDmServicesCommonContractsPocOsTemplateBody {
-  /**
-   * Content that will be used for all channels (SMS and WhatsApp) unless
-   * channel-specific content is provided
-   */
-  multiChannel?: TemplateBodyContent | null;
-
+export namespace TemplateCreateResponse {
   /**
-   * SMS-specific content that overrides multi-channel content for SMS messages
+   * Template response for v3 API
    */
-  sms?: TemplateBodyContent | null;
+  export interface Data {
+    /**
+     * Unique template identifier
+     */
+    id?: string;
 
-  /**
-   * WhatsApp-specific content that overrides multi-channel content for WhatsApp
-   * messages
-   */
-  whatsapp?: TemplateBodyContent | null;
-}
+    /**
+     * Template category: MARKETING, UTILITY, AUTHENTICATION
+     */
+    category?: string;
 
-/**
- * Interactive button in a message template
- */
-export interface SentDmServicesCommonContractsPocOsTemplateButton {
-  /**
-   * Properties specific to the button type
-   */
-  props: SentDmServicesCommonContractsPocOsTemplateButtonProps;
+    /**
+     * Supported channels: sms, whatsapp
+     */
+    channels?: Array<string> | null;
 
-  /**
-   * The type of button (e.g., QUICK_REPLY, URL, PHONE_NUMBER, VOICE_CALL, COPY_CODE)
-   */
-  type: string;
+    /**
+     * When the template was created
+     */
+    created_at?: string;
 
-  /**
-   * The unique identifier of the button (1-based index)
-   */
-  id?: number;
-}
+    /**
+     * Whether the template is published and active
+     */
+    is_published?: boolean;
 
-export interface SentDmServicesCommonContractsPocOsTemplateButtonProps {
-  activeFor: number;
+    /**
+     * Template language code (e.g., en_US)
+     */
+    language?: string;
 
-  countryCode: string;
+    /**
+     * Template display name
+     */
+    name?: string;
 
-  offerCode: string;
+    /**
+     * Template status: APPROVED, PENDING, REJECTED
+     */
+    status?: string;
 
-  phoneNumber: string;
+    /**
+     * When the template was last updated
+     */
+    updated_at?: string | null;
 
-  quickReplyType: string;
+    /**
+     * Template variables for personalization
+     */
+    variables?: Array<string> | null;
+  }
 
-  text: string;
+  /**
+   * Error information
+   */
+  export interface Error {
+    /**
+     * Machine-readable error code (e.g., "RESOURCE_001")
+     */
+    code?: string;
 
-  url: string;
+    /**
+     * Additional validation error details (field-level errors)
+     */
+    details?: { [key: string]: Array<string> } | null;
 
-  urlType: string;
+    /**
+     * URL to documentation about this error
+     */
+    doc_url?: string | null;
 
-  autofillText?: string | null;
+    /**
+     * Human-readable error message
+     */
+    message?: string;
+  }
 
-  otpType?: string | null;
+  /**
+   * Request and response metadata
+   */
+  export interface Meta {
+    /**
+     * Unique identifier for this request (for tracing and support)
+     */
+    request_id?: string;
 
-  packageName?: string | null;
+    /**
+     * Server timestamp when the response was generated
+     */
+    timestamp?: string;
 
-  signatureHash?: string | null;
+    /**
+     * API version used for this request
+     */
+    version?: string;
+  }
 }
 
 /**
- * Footer section of a message template
+ * Standard API response envelope for all v3 endpoints
  */
-export interface SentDmServicesCommonContractsPocOsTemplateFooter {
+export interface TemplateRetrieveResponse {
   /**
-   * The footer template text with optional variable placeholders
+   * Template response for v3 API
    */
-  template: string;
+  data?: TemplateRetrieveResponse.Data | null;
 
   /**
-   * The type of footer (typically "text")
+   * Error information
    */
-  type?: string | null;
+  error?: TemplateRetrieveResponse.Error | null;
 
   /**
-   * List of variables used in the footer template
+   * Request and response metadata
    */
-  variables?: Array<TemplateVariable> | null;
-}
+  meta?: TemplateRetrieveResponse.Meta;
 
-/**
- * Header section of a message template
- */
-export interface SentDmServicesCommonContractsPocOsTemplateHeader {
   /**
-   * The header template text with optional variable placeholders (e.g., "Welcome to
-   * {{0:variable}}")
+   * Indicates whether the request was successful
    */
-  template: string;
+  success?: boolean;
+}
 
+export namespace TemplateRetrieveResponse {
   /**
-   * The type of header (e.g., "text", "image", "video", "document")
+   * Template response for v3 API
    */
-  type?: string | null;
+  export interface Data {
+    /**
+     * Unique template identifier
+     */
+    id?: string;
 
-  /**
-   * List of variables used in the header template
-   */
-  variables?: Array<TemplateVariable> | null;
-}
+    /**
+     * Template category: MARKETING, UTILITY, AUTHENTICATION
+     */
+    category?: string;
 
-/**
- * Template response for v3 API
- */
-export interface Template {
-  /**
-   * Unique template identifier
-   */
-  id?: string;
+    /**
+     * Supported channels: sms, whatsapp
+     */
+    channels?: Array<string> | null;
 
-  /**
-   * Template category: MARKETING, UTILITY, AUTHENTICATION
-   */
-  category?: string;
+    /**
+     * When the template was created
+     */
+    created_at?: string;
 
-  /**
-   * Supported channels: sms, whatsapp
-   */
-  channels?: Array<string> | null;
+    /**
+     * Whether the template is published and active
+     */
+    is_published?: boolean;
 
-  /**
-   * When the template was created
-   */
-  created_at?: string;
+    /**
+     * Template language code (e.g., en_US)
+     */
+    language?: string;
 
-  /**
-   * Whether the template is published and active
-   */
-  is_published?: boolean;
+    /**
+     * Template display name
+     */
+    name?: string;
 
-  /**
-   * Template language code (e.g., en_US)
-   */
-  language?: string;
+    /**
+     * Template status: APPROVED, PENDING, REJECTED
+     */
+    status?: string;
 
-  /**
-   * Template display name
-   */
-  name?: string;
+    /**
+     * When the template was last updated
+     */
+    updated_at?: string | null;
 
-  /**
-   * Template status: APPROVED, PENDING, REJECTED
-   */
-  status?: string;
+    /**
+     * Template variables for personalization
+     */
+    variables?: Array<string> | null;
+  }
 
   /**
-   * When the template was last updated
+   * Error information
    */
-  updated_at?: string | null;
+  export interface Error {
+    /**
+     * Machine-readable error code (e.g., "RESOURCE_001")
+     */
+    code?: string;
+
+    /**
+     * Additional validation error details (field-level errors)
+     */
+    details?: { [key: string]: Array<string> } | null;
+
+    /**
+     * URL to documentation about this error
+     */
+    doc_url?: string | null;
+
+    /**
+     * Human-readable error message
+     */
+    message?: string;
+  }
 
   /**
-   * Template variables for personalization
+   * Request and response metadata
    */
-  variables?: Array<string> | null;
-}
-
-export interface TemplateBodyContent {
-  template: string;
+  export interface Meta {
+    /**
+     * Unique identifier for this request (for tracing and support)
+     */
+    request_id?: string;
 
-  type?: string | null;
+    /**
+     * Server timestamp when the response was generated
+     */
+    timestamp?: string;
 
-  variables?: Array<TemplateVariable> | null;
+    /**
+     * API version used for this request
+     */
+    version?: string;
+  }
 }
 
 /**
- * Complete definition of a message template including header, body, footer, and
- * buttons
+ * Standard API response envelope for all v3 endpoints
  */
-export interface TemplateDefinition {
+export interface TemplateUpdateResponse {
   /**
-   * Body section of a message template with channel-specific content
+   * Template response for v3 API
    */
-  body: SentDmServicesCommonContractsPocOsTemplateBody;
+  data?: TemplateUpdateResponse.Data | null;
 
   /**
-   * Configuration for AUTHENTICATION category templates
+   * Error information
    */
-  authenticationConfig?: SentDmServicesCommonContractsPocOsAuthenticationConfig | null;
+  error?: TemplateUpdateResponse.Error | null;
 
   /**
-   * Optional list of interactive buttons (e.g., quick replies, URLs, phone numbers)
+   * Request and response metadata
    */
-  buttons?: Array<SentDmServicesCommonContractsPocOsTemplateButton> | null;
+  meta?: TemplateUpdateResponse.Meta;
 
   /**
-   * The version of the template definition format
+   * Indicates whether the request was successful
    */
-  definitionVersion?: string | null;
+  success?: boolean;
+}
 
+export namespace TemplateUpdateResponse {
   /**
-   * Footer section of a message template
+   * Template response for v3 API
    */
-  footer?: SentDmServicesCommonContractsPocOsTemplateFooter | null;
+  export interface Data {
+    /**
+     * Unique template identifier
+     */
+    id?: string;
 
-  /**
-   * Header section of a message template
-   */
-  header?: SentDmServicesCommonContractsPocOsTemplateHeader | null;
-}
+    /**
+     * Template category: MARKETING, UTILITY, AUTHENTICATION
+     */
+    category?: string;
 
-export interface TemplateVariable {
-  name: string;
+    /**
+     * Supported channels: sms, whatsapp
+     */
+    channels?: Array<string> | null;
+
+    /**
+     * When the template was created
+     */
+    created_at?: string;
 
-  props: TemplateVariable.Props;
+    /**
+     * Whether the template is published and active
+     */
+    is_published?: boolean;
 
-  type: string;
+    /**
+     * Template language code (e.g., en_US)
+     */
+    language?: string;
 
-  id?: number;
-}
+    /**
+     * Template display name
+     */
+    name?: string;
 
-export namespace TemplateVariable {
-  export interface Props {
-    mediaType: string;
+    /**
+     * Template status: APPROVED, PENDING, REJECTED
+     */
+    status?: string;
+
+    /**
+     * When the template was last updated
+     */
+    updated_at?: string | null;
+
+    /**
+     * Template variables for personalization
+     */
+    variables?: Array<string> | null;
+  }
+
+  /**
+   * Error information
+   */
+  export interface Error {
+    /**
+     * Machine-readable error code (e.g., "RESOURCE_001")
+     */
+    code?: string;
 
-    sample: string;
+    /**
+     * Additional validation error details (field-level errors)
+     */
+    details?: { [key: string]: Array<string> } | null;
 
-    url: string;
+    /**
+     * URL to documentation about this error
+     */
+    doc_url?: string | null;
 
-    variableType: string;
+    /**
+     * Human-readable error message
+     */
+    message?: string;
+  }
 
-    alt?: string | null;
+  /**
+   * Request and response metadata
+   */
+  export interface Meta {
+    /**
+     * Unique identifier for this request (for tracing and support)
+     */
+    request_id?: string;
 
-    regex?: string | null;
+    /**
+     * Server timestamp when the response was generated
+     */
+    timestamp?: string;
 
-    shortUrl?: string | null;
+    /**
+     * API version used for this request
+     */
+    version?: string;
   }
 }
 
@@ -431,12 +532,12 @@ export interface TemplateListResponse {
   /**
    * Error information
    */
-  error?: WebhooksAPI.ErrorDetail | null;
+  error?: TemplateListResponse.Error | null;
 
   /**
    * Request and response metadata
    */
-  meta?: WebhooksAPI.APIMeta;
+  meta?: TemplateListResponse.Meta;
 
   /**
    * Indicates whether the request was successful
@@ -452,12 +553,166 @@ export namespace TemplateListResponse {
     /**
      * Pagination metadata for list responses
      */
-    pagination?: WebhooksAPI.PaginationMeta;
+    pagination?: Data.Pagination;
 
     /**
      * List of templates
      */
-    templates?: Array<TemplatesAPI.Template>;
+    templates?: Array<Data.Template>;
+  }
+
+  export namespace Data {
+    /**
+     * Pagination metadata for list responses
+     */
+    export interface Pagination {
+      /**
+       * Cursor-based pagination pointers
+       */
+      cursors?: Pagination.Cursors | null;
+
+      /**
+       * Whether there are more pages after this one
+       */
+      has_more?: boolean;
+
+      /**
+       * Current page number (1-indexed)
+       */
+      page?: number;
+
+      /**
+       * Number of items per page
+       */
+      page_size?: number;
+
+      /**
+       * Total number of items across all pages
+       */
+      total_count?: number;
+
+      /**
+       * Total number of pages
+       */
+      total_pages?: number;
+    }
+
+    export namespace Pagination {
+      /**
+       * Cursor-based pagination pointers
+       */
+      export interface Cursors {
+        /**
+         * Cursor to fetch the next page
+         */
+        after?: string | null;
+
+        /**
+         * Cursor to fetch the previous page
+         */
+        before?: string | null;
+      }
+    }
+
+    /**
+     * Template response for v3 API
+     */
+    export interface Template {
+      /**
+       * Unique template identifier
+       */
+      id?: string;
+
+      /**
+       * Template category: MARKETING, UTILITY, AUTHENTICATION
+       */
+      category?: string;
+
+      /**
+       * Supported channels: sms, whatsapp
+       */
+      channels?: Array<string> | null;
+
+      /**
+       * When the template was created
+       */
+      created_at?: string;
+
+      /**
+       * Whether the template is published and active
+       */
+      is_published?: boolean;
+
+      /**
+       * Template language code (e.g., en_US)
+       */
+      language?: string;
+
+      /**
+       * Template display name
+       */
+      name?: string;
+
+      /**
+       * Template status: APPROVED, PENDING, REJECTED
+       */
+      status?: string;
+
+      /**
+       * When the template was last updated
+       */
+      updated_at?: string | null;
+
+      /**
+       * Template variables for personalization
+       */
+      variables?: Array<string> | null;
+    }
+  }
+
+  /**
+   * Error information
+   */
+  export interface Error {
+    /**
+     * Machine-readable error code (e.g., "RESOURCE_001")
+     */
+    code?: string;
+
+    /**
+     * Additional validation error details (field-level errors)
+     */
+    details?: { [key: string]: Array<string> } | null;
+
+    /**
+     * URL to documentation about this error
+     */
+    doc_url?: string | null;
+
+    /**
+     * Human-readable error message
+     */
+    message?: string;
+  }
+
+  /**
+   * Request and response metadata
+   */
+  export interface Meta {
+    /**
+     * Unique identifier for this request (for tracing and support)
+     */
+    request_id?: string;
+
+    /**
+     * Server timestamp when the response was generated
+     */
+    timestamp?: string;
+
+    /**
+     * API version used for this request
+     */
+    version?: string;
   }
 }
 
@@ -477,7 +732,7 @@ export interface TemplateCreateParams {
    * Body param: Complete definition of a message template including header, body,
    * footer, and buttons
    */
-  definition?: TemplateDefinition;
+  definition?: TemplateCreateParams.Definition;
 
   /**
    * Body param: Template language code (e.g., en_US) (optional, auto-detected if not
@@ -512,25 +767,429 @@ export interface TemplateCreateParams {
   'x-profile-id'?: string;
 }
 
-export interface TemplateRetrieveParams {
+export namespace TemplateCreateParams {
   /**
-   * Profile UUID to scope the request to a child profile. Only organization API keys
-   * can use this header. The profile must belong to the calling organization.
+   * Complete definition of a message template including header, body, footer, and
+   * buttons
    */
-  'x-profile-id'?: string;
-}
+  export interface Definition {
+    /**
+     * Body section of a message template with channel-specific content
+     */
+    body: Definition.Body;
 
-export interface TemplateUpdateParams {
-  /**
-   * Body param: Template category: MARKETING, UTILITY, AUTHENTICATION
-   */
-  category?: string | null;
+    /**
+     * Configuration for AUTHENTICATION category templates
+     */
+    authenticationConfig?: Definition.AuthenticationConfig | null;
+
+    /**
+     * Optional list of interactive buttons (e.g., quick replies, URLs, phone numbers)
+     */
+    buttons?: Array<Definition.Button> | null;
+
+    /**
+     * The version of the template definition format
+     */
+    definitionVersion?: string | null;
+
+    /**
+     * Footer section of a message template
+     */
+    footer?: Definition.Footer | null;
+
+    /**
+     * Header section of a message template
+     */
+    header?: Definition.Header | null;
+  }
+
+  export namespace Definition {
+    /**
+     * Body section of a message template with channel-specific content
+     */
+    export interface Body {
+      /**
+       * Content that will be used for all channels (SMS and WhatsApp) unless
+       * channel-specific content is provided
+       */
+      multiChannel?: Body.MultiChannel | null;
+
+      /**
+       * RCS-specific content that overrides multi-channel content for RCS messages
+       */
+      rcs?: Body.Rcs | null;
+
+      /**
+       * SMS-specific content that overrides multi-channel content for SMS messages
+       */
+      sms?: Body.SMS | null;
+
+      /**
+       * WhatsApp-specific content that overrides multi-channel content for WhatsApp
+       * messages
+       */
+      whatsapp?: Body.Whatsapp | null;
+    }
+
+    export namespace Body {
+      /**
+       * Content that will be used for all channels (SMS and WhatsApp) unless
+       * channel-specific content is provided
+       */
+      export interface MultiChannel {
+        template: string;
+
+        type?: string | null;
+
+        variables?: Array<MultiChannel.Variable> | null;
+      }
+
+      export namespace MultiChannel {
+        export interface Variable {
+          name: string;
+
+          props: Variable.Props;
+
+          type: string;
+
+          id?: number;
+        }
+
+        export namespace Variable {
+          export interface Props {
+            mediaType: string;
+
+            sample: string;
+
+            url: string;
+
+            variableType: string;
+
+            alt?: string | null;
+
+            regex?: string | null;
+
+            shortUrl?: string | null;
+          }
+        }
+      }
+
+      /**
+       * RCS-specific content that overrides multi-channel content for RCS messages
+       */
+      export interface Rcs {
+        template: string;
+
+        type?: string | null;
+
+        variables?: Array<Rcs.Variable> | null;
+      }
+
+      export namespace Rcs {
+        export interface Variable {
+          name: string;
+
+          props: Variable.Props;
+
+          type: string;
+
+          id?: number;
+        }
+
+        export namespace Variable {
+          export interface Props {
+            mediaType: string;
+
+            sample: string;
+
+            url: string;
+
+            variableType: string;
+
+            alt?: string | null;
+
+            regex?: string | null;
+
+            shortUrl?: string | null;
+          }
+        }
+      }
+
+      /**
+       * SMS-specific content that overrides multi-channel content for SMS messages
+       */
+      export interface SMS {
+        template: string;
+
+        type?: string | null;
+
+        variables?: Array<SMS.Variable> | null;
+      }
+
+      export namespace SMS {
+        export interface Variable {
+          name: string;
+
+          props: Variable.Props;
+
+          type: string;
+
+          id?: number;
+        }
+
+        export namespace Variable {
+          export interface Props {
+            mediaType: string;
+
+            sample: string;
+
+            url: string;
+
+            variableType: string;
+
+            alt?: string | null;
+
+            regex?: string | null;
+
+            shortUrl?: string | null;
+          }
+        }
+      }
+
+      /**
+       * WhatsApp-specific content that overrides multi-channel content for WhatsApp
+       * messages
+       */
+      export interface Whatsapp {
+        template: string;
+
+        type?: string | null;
+
+        variables?: Array<Whatsapp.Variable> | null;
+      }
+
+      export namespace Whatsapp {
+        export interface Variable {
+          name: string;
+
+          props: Variable.Props;
+
+          type: string;
+
+          id?: number;
+        }
+
+        export namespace Variable {
+          export interface Props {
+            mediaType: string;
+
+            sample: string;
+
+            url: string;
+
+            variableType: string;
+
+            alt?: string | null;
+
+            regex?: string | null;
+
+            shortUrl?: string | null;
+          }
+        }
+      }
+    }
+
+    /**
+     * Configuration for AUTHENTICATION category templates
+     */
+    export interface AuthenticationConfig {
+      /**
+       * Whether to add the security recommendation text: "For your security, do not
+       * share this code."
+       */
+      addSecurityRecommendation?: boolean;
+
+      /**
+       * Code expiration time in minutes (1-90). If set, adds footer: "This code expires
+       * in X minutes."
+       */
+      codeExpirationMinutes?: number | null;
+    }
+
+    /**
+     * Interactive button in a message template
+     */
+    export interface Button {
+      /**
+       * Properties specific to the button type
+       */
+      props: Button.Props;
+
+      /**
+       * The type of button (e.g., QUICK_REPLY, URL, PHONE_NUMBER, VOICE_CALL, COPY_CODE)
+       */
+      type: string;
+
+      /**
+       * The unique identifier of the button (1-based index)
+       */
+      id?: number;
+    }
+
+    export namespace Button {
+      /**
+       * Properties specific to the button type
+       */
+      export interface Props {
+        activeFor: number;
+
+        countryCode: string;
+
+        offerCode: string;
+
+        phoneNumber: string;
+
+        quickReplyType: string;
+
+        text: string;
+
+        url: string;
+
+        urlType: string;
+
+        autofillText?: string | null;
+
+        otpType?: string | null;
+
+        packageName?: string | null;
+
+        signatureHash?: string | null;
+      }
+    }
+
+    /**
+     * Footer section of a message template
+     */
+    export interface Footer {
+      /**
+       * The footer template text with optional variable placeholders
+       */
+      template: string;
+
+      /**
+       * The type of footer (typically "text")
+       */
+      type?: string | null;
+
+      /**
+       * List of variables used in the footer template
+       */
+      variables?: Array<Footer.Variable> | null;
+    }
+
+    export namespace Footer {
+      export interface Variable {
+        name: string;
+
+        props: Variable.Props;
+
+        type: string;
+
+        id?: number;
+      }
+
+      export namespace Variable {
+        export interface Props {
+          mediaType: string;
+
+          sample: string;
+
+          url: string;
+
+          variableType: string;
+
+          alt?: string | null;
+
+          regex?: string | null;
+
+          shortUrl?: string | null;
+        }
+      }
+    }
+
+    /**
+     * Header section of a message template
+     */
+    export interface Header {
+      /**
+       * The header template text with optional variable placeholders (e.g., "Welcome to
+       * {{0:variable}}")
+       */
+      template: string;
+
+      /**
+       * The type of header (e.g., "text", "image", "video", "document")
+       */
+      type?: string | null;
+
+      /**
+       * List of variables used in the header template
+       */
+      variables?: Array<Header.Variable> | null;
+    }
+
+    export namespace Header {
+      export interface Variable {
+        name: string;
+
+        props: Variable.Props;
+
+        type: string;
+
+        id?: number;
+      }
+
+      export namespace Variable {
+        export interface Props {
+          mediaType: string;
+
+          sample: string;
+
+          url: string;
+
+          variableType: string;
+
+          alt?: string | null;
+
+          regex?: string | null;
+
+          shortUrl?: string | null;
+        }
+      }
+    }
+  }
+}
+
+export interface TemplateRetrieveParams {
+  /**
+   * Profile UUID to scope the request to a child profile. Only organization API keys
+   * can use this header. The profile must belong to the calling organization.
+   */
+  'x-profile-id'?: string;
+}
+
+export interface TemplateUpdateParams {
+  /**
+   * Body param: Template category: MARKETING, UTILITY, AUTHENTICATION
+   */
+  category?: string | null;
 
   /**
    * Body param: Complete definition of a message template including header, body,
    * footer, and buttons
    */
-  definition?: TemplateDefinition | null;
+  definition?: TemplateUpdateParams.Definition | null;
 
   /**
    * Body param: Template language code (e.g., en_US)
@@ -569,6 +1228,410 @@ export interface TemplateUpdateParams {
   'x-profile-id'?: string;
 }
 
+export namespace TemplateUpdateParams {
+  /**
+   * Complete definition of a message template including header, body, footer, and
+   * buttons
+   */
+  export interface Definition {
+    /**
+     * Body section of a message template with channel-specific content
+     */
+    body: Definition.Body;
+
+    /**
+     * Configuration for AUTHENTICATION category templates
+     */
+    authenticationConfig?: Definition.AuthenticationConfig | null;
+
+    /**
+     * Optional list of interactive buttons (e.g., quick replies, URLs, phone numbers)
+     */
+    buttons?: Array<Definition.Button> | null;
+
+    /**
+     * The version of the template definition format
+     */
+    definitionVersion?: string | null;
+
+    /**
+     * Footer section of a message template
+     */
+    footer?: Definition.Footer | null;
+
+    /**
+     * Header section of a message template
+     */
+    header?: Definition.Header | null;
+  }
+
+  export namespace Definition {
+    /**
+     * Body section of a message template with channel-specific content
+     */
+    export interface Body {
+      /**
+       * Content that will be used for all channels (SMS and WhatsApp) unless
+       * channel-specific content is provided
+       */
+      multiChannel?: Body.MultiChannel | null;
+
+      /**
+       * RCS-specific content that overrides multi-channel content for RCS messages
+       */
+      rcs?: Body.Rcs | null;
+
+      /**
+       * SMS-specific content that overrides multi-channel content for SMS messages
+       */
+      sms?: Body.SMS | null;
+
+      /**
+       * WhatsApp-specific content that overrides multi-channel content for WhatsApp
+       * messages
+       */
+      whatsapp?: Body.Whatsapp | null;
+    }
+
+    export namespace Body {
+      /**
+       * Content that will be used for all channels (SMS and WhatsApp) unless
+       * channel-specific content is provided
+       */
+      export interface MultiChannel {
+        template: string;
+
+        type?: string | null;
+
+        variables?: Array<MultiChannel.Variable> | null;
+      }
+
+      export namespace MultiChannel {
+        export interface Variable {
+          name: string;
+
+          props: Variable.Props;
+
+          type: string;
+
+          id?: number;
+        }
+
+        export namespace Variable {
+          export interface Props {
+            mediaType: string;
+
+            sample: string;
+
+            url: string;
+
+            variableType: string;
+
+            alt?: string | null;
+
+            regex?: string | null;
+
+            shortUrl?: string | null;
+          }
+        }
+      }
+
+      /**
+       * RCS-specific content that overrides multi-channel content for RCS messages
+       */
+      export interface Rcs {
+        template: string;
+
+        type?: string | null;
+
+        variables?: Array<Rcs.Variable> | null;
+      }
+
+      export namespace Rcs {
+        export interface Variable {
+          name: string;
+
+          props: Variable.Props;
+
+          type: string;
+
+          id?: number;
+        }
+
+        export namespace Variable {
+          export interface Props {
+            mediaType: string;
+
+            sample: string;
+
+            url: string;
+
+            variableType: string;
+
+            alt?: string | null;
+
+            regex?: string | null;
+
+            shortUrl?: string | null;
+          }
+        }
+      }
+
+      /**
+       * SMS-specific content that overrides multi-channel content for SMS messages
+       */
+      export interface SMS {
+        template: string;
+
+        type?: string | null;
+
+        variables?: Array<SMS.Variable> | null;
+      }
+
+      export namespace SMS {
+        export interface Variable {
+          name: string;
+
+          props: Variable.Props;
+
+          type: string;
+
+          id?: number;
+        }
+
+        export namespace Variable {
+          export interface Props {
+            mediaType: string;
+
+            sample: string;
+
+            url: string;
+
+            variableType: string;
+
+            alt?: string | null;
+
+            regex?: string | null;
+
+            shortUrl?: string | null;
+          }
+        }
+      }
+
+      /**
+       * WhatsApp-specific content that overrides multi-channel content for WhatsApp
+       * messages
+       */
+      export interface Whatsapp {
+        template: string;
+
+        type?: string | null;
+
+        variables?: Array<Whatsapp.Variable> | null;
+      }
+
+      export namespace Whatsapp {
+        export interface Variable {
+          name: string;
+
+          props: Variable.Props;
+
+          type: string;
+
+          id?: number;
+        }
+
+        export namespace Variable {
+          export interface Props {
+            mediaType: string;
+
+            sample: string;
+
+            url: string;
+
+            variableType: string;
+
+            alt?: string | null;
+
+            regex?: string | null;
+
+            shortUrl?: string | null;
+          }
+        }
+      }
+    }
+
+    /**
+     * Configuration for AUTHENTICATION category templates
+     */
+    export interface AuthenticationConfig {
+      /**
+       * Whether to add the security recommendation text: "For your security, do not
+       * share this code."
+       */
+      addSecurityRecommendation?: boolean;
+
+      /**
+       * Code expiration time in minutes (1-90). If set, adds footer: "This code expires
+       * in X minutes."
+       */
+      codeExpirationMinutes?: number | null;
+    }
+
+    /**
+     * Interactive button in a message template
+     */
+    export interface Button {
+      /**
+       * Properties specific to the button type
+       */
+      props: Button.Props;
+
+      /**
+       * The type of button (e.g., QUICK_REPLY, URL, PHONE_NUMBER, VOICE_CALL, COPY_CODE)
+       */
+      type: string;
+
+      /**
+       * The unique identifier of the button (1-based index)
+       */
+      id?: number;
+    }
+
+    export namespace Button {
+      /**
+       * Properties specific to the button type
+       */
+      export interface Props {
+        activeFor: number;
+
+        countryCode: string;
+
+        offerCode: string;
+
+        phoneNumber: string;
+
+        quickReplyType: string;
+
+        text: string;
+
+        url: string;
+
+        urlType: string;
+
+        autofillText?: string | null;
+
+        otpType?: string | null;
+
+        packageName?: string | null;
+
+        signatureHash?: string | null;
+      }
+    }
+
+    /**
+     * Footer section of a message template
+     */
+    export interface Footer {
+      /**
+       * The footer template text with optional variable placeholders
+       */
+      template: string;
+
+      /**
+       * The type of footer (typically "text")
+       */
+      type?: string | null;
+
+      /**
+       * List of variables used in the footer template
+       */
+      variables?: Array<Footer.Variable> | null;
+    }
+
+    export namespace Footer {
+      export interface Variable {
+        name: string;
+
+        props: Variable.Props;
+
+        type: string;
+
+        id?: number;
+      }
+
+      export namespace Variable {
+        export interface Props {
+          mediaType: string;
+
+          sample: string;
+
+          url: string;
+
+          variableType: string;
+
+          alt?: string | null;
+
+          regex?: string | null;
+
+          shortUrl?: string | null;
+        }
+      }
+    }
+
+    /**
+     * Header section of a message template
+     */
+    export interface Header {
+      /**
+       * The header template text with optional variable placeholders (e.g., "Welcome to
+       * {{0:variable}}")
+       */
+      template: string;
+
+      /**
+       * The type of header (e.g., "text", "image", "video", "document")
+       */
+      type?: string | null;
+
+      /**
+       * List of variables used in the header template
+       */
+      variables?: Array<Header.Variable> | null;
+    }
+
+    export namespace Header {
+      export interface Variable {
+        name: string;
+
+        props: Variable.Props;
+
+        type: string;
+
+        id?: number;
+      }
+
+      export namespace Variable {
+        export interface Props {
+          mediaType: string;
+
+          sample: string;
+
+          url: string;
+
+          variableType: string;
+
+          alt?: string | null;
+
+          regex?: string | null;
+
+          shortUrl?: string | null;
+        }
+      }
+    }
+  }
+}
+
 export interface TemplateListParams {
   /**
    * Query param: Page number (1-indexed)
@@ -631,17 +1694,9 @@ export interface TemplateDeleteParams {
 
 export declare namespace Templates {
   export {
-    type APIResponseTemplate as APIResponseTemplate,
-    type SentDmServicesCommonContractsPocOsAuthenticationConfig as SentDmServicesCommonContractsPocOsAuthenticationConfig,
-    type SentDmServicesCommonContractsPocOsTemplateBody as SentDmServicesCommonContractsPocOsTemplateBody,
-    type SentDmServicesCommonContractsPocOsTemplateButton as SentDmServicesCommonContractsPocOsTemplateButton,
-    type SentDmServicesCommonContractsPocOsTemplateButtonProps as SentDmServicesCommonContractsPocOsTemplateButtonProps,
-    type SentDmServicesCommonContractsPocOsTemplateFooter as SentDmServicesCommonContractsPocOsTemplateFooter,
-    type SentDmServicesCommonContractsPocOsTemplateHeader as SentDmServicesCommonContractsPocOsTemplateHeader,
-    type Template as Template,
-    type TemplateBodyContent as TemplateBodyContent,
-    type TemplateDefinition as TemplateDefinition,
-    type TemplateVariable as TemplateVariable,
+    type TemplateCreateResponse as TemplateCreateResponse,
+    type TemplateRetrieveResponse as TemplateRetrieveResponse,
+    type TemplateUpdateResponse as TemplateUpdateResponse,
     type TemplateListResponse as TemplateListResponse,
     type TemplateCreateParams as TemplateCreateParams,
     type TemplateRetrieveParams as TemplateRetrieveParams,