sentdm 0.1.0 → 0.3.0

data/lib/sentdm/resources/messages.rb

@@ -3,118 +3,83 @@
 module Sentdm
   module Resources
     class Messages
-      # Retrieves comprehensive details about a specific message using the message ID.
-      # Returns complete message data including delivery status, channel information,
-      # template details, contact information, and pricing. The customer ID is extracted
-      # from the authentication token to ensure the message belongs to the authenticated
-      # customer.
+      # Retrieves the activity log for a specific message. Activities track the message
+      # lifecycle including acceptance, processing, sending, delivery, and any errors.
       #
-      # @overload retrieve(id, request_options: {})
+      # @overload retrieve_activities(id, request_options: {})
+      #
+      # @param id [String] Message ID from route parameter
       #
-      # @param id [String]
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Sentdm::Models::MessageRetrieveResponse]
+      # @return [Sentdm::Models::MessageRetrieveActivitiesResponse]
       #
-      # @see Sentdm::Models::MessageRetrieveParams
-      def retrieve(id, params = {})
+      # @see Sentdm::Models::MessageRetrieveActivitiesParams
+      def retrieve_activities(id, params = {})
         @client.request(
           method: :get,
-          path: ["v2/messages/%1$s", id],
-          model: Sentdm::Models::MessageRetrieveResponse,
+          path: ["v3/messages/%1$s/activities", id],
+          model: Sentdm::Models::MessageRetrieveActivitiesResponse,
           options: params[:request_options]
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {Sentdm::Models::MessageSendQuickMessageParams} for more details.
-      #
-      # Sends a message to a phone number using the default template. This endpoint is
-      # rate limited to 5 messages per customer per day. The customer ID is extracted
-      # from the authentication token.
+      # Retrieves the current status and details of a message by ID. Includes delivery
+      # status, timestamps, and error information if applicable.
       #
-      # @overload send_quick_message(custom_message:, phone_number:, request_options: {})
+      # @overload retrieve_status(id, request_options: {})
       #
-      # @param custom_message [String] The custom message content to include in the template
-      #
-      # @param phone_number [String] The phone number to send the message to, in international format (e.g., +1234567
+      # @param id [String] Message ID
       #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [nil]
+      # @return [Sentdm::Models::MessageRetrieveStatusResponse]
       #
-      # @see Sentdm::Models::MessageSendQuickMessageParams
-      def send_quick_message(params)
-        parsed, options = Sentdm::MessageSendQuickMessageParams.dump_request(params)
+      # @see Sentdm::Models::MessageRetrieveStatusParams
+      def retrieve_status(id, params = {})
         @client.request(
-          method: :post,
-          path: "v2/messages/quick-message",
-          body: parsed,
-          model: NilClass,
-          options: options
+          method: :get,
+          path: ["v3/messages/%1$s", id],
+          model: Sentdm::Models::MessageRetrieveStatusResponse,
+          options: params[:request_options]
         )
       end
 
       # Some parameter documentations has been truncated, see
-      # {Sentdm::Models::MessageSendToContactParams} for more details.
-      #
-      # Sends a message to a specific contact using a template. The message can be sent
-      # via SMS or WhatsApp depending on the contact's capabilities. Optionally specify
-      # a webhook URL to receive delivery status updates. The customer ID is extracted
-      # from the authentication token.
-      #
-      # @overload send_to_contact(contact_id:, template_id:, template_variables: nil, request_options: {})
-      #
-      # @param contact_id [String] The unique identifier of the contact to send the message to
+      # {Sentdm::Models::MessageSendParams} for more details.
       #
-      # @param template_id [String] The unique identifier of the template to use for the message
+      # Sends a message to one or more recipients using a template. Supports
+      # multi-channel broadcast — when multiple channels are specified (e.g. ["sms",
+      # "whatsapp"]), a separate message is created for each (recipient, channel) pair.
+      # Returns immediately with per-recipient message IDs for async tracking via
+      # webhooks or the GET /messages/{id} endpoint.
       #
-      # @param template_variables [Hash{Symbol=>String}, nil] Optional key-value pairs of template variables to replace in the template body.
-      #
-      # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [nil]
-      #
-      # @see Sentdm::Models::MessageSendToContactParams
-      def send_to_contact(params)
-        parsed, options = Sentdm::MessageSendToContactParams.dump_request(params)
-        @client.request(
-          method: :post,
-          path: "v2/messages/contact",
-          body: parsed,
-          model: NilClass,
-          options: options
-        )
-      end
-
-      # Some parameter documentations has been truncated, see
-      # {Sentdm::Models::MessageSendToPhoneParams} for more details.
+      # @overload send_(channel: nil, template: nil, test_mode: nil, to: nil, idempotency_key: nil, request_options: {})
       #
-      # Sends a message to a phone number using a template. The phone number doesn't
-      # need to be a pre-existing contact. The message can be sent via SMS or WhatsApp.
-      # Optionally specify a webhook URL to receive delivery status updates. The
-      # customer ID is extracted from the authentication token.
+      # @param channel [Array<String>, nil] Body param: Channels to broadcast on, e.g. ["whatsapp", "sms"].
       #
-      # @overload send_to_phone(phone_number:, template_id:, template_variables: nil, request_options: {})
+      # @param template [Sentdm::Models::MessageSendParams::Template] Body param: Template reference (by id or name, with optional parameters)
       #
-      # @param phone_number [String] The phone number to send the message to, in international format (e.g., +1234567
+      # @param test_mode [Boolean] Body param: Test mode flag - when true, the operation is simulated without side
       #
-      # @param template_id [String] The unique identifier of the template to use for the message
+      # @param to [Array<String>] Body param: List of recipient phone numbers in E.164 format (multi-recipient fan
       #
-      # @param template_variables [Hash{Symbol=>String}, nil] Optional key-value pairs of template variables to replace in the template body.
+      # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
       #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [nil]
+      # @return [Sentdm::Models::MessageSendResponse]
       #
-      # @see Sentdm::Models::MessageSendToPhoneParams
-      def send_to_phone(params)
-        parsed, options = Sentdm::MessageSendToPhoneParams.dump_request(params)
+      # @see Sentdm::Models::MessageSendParams
+      def send_(params = {})
+        parsed, options = Sentdm::MessageSendParams.dump_request(params)
+        header_params = {idempotency_key: "idempotency-key"}
         @client.request(
           method: :post,
-          path: "v2/messages/phone",
-          body: parsed,
-          model: NilClass,
+          path: "v3/messages",
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: Sentdm::Models::MessageSendResponse,
           options: options
         )
       end

data/lib/sentdm/resources/profiles.rb

@@ -0,0 +1,254 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Resources
+    class Profiles
+      # Some parameter documentations has been truncated, see
+      # {Sentdm::Models::ProfileCreateParams} for more details.
+      #
+      # Creates a new sender profile within an organization. Profiles represent
+      # different brands, departments, or use cases, each with their own messaging
+      # configuration and settings. Requires admin role in the organization.
+      #
+      # @overload create(allow_contact_sharing: nil, allow_template_sharing: nil, billing_model: nil, description: nil, icon: nil, inherit_contacts: nil, inherit_tcr_brand: nil, inherit_tcr_campaign: nil, inherit_templates: nil, name: nil, short_name: nil, test_mode: nil, idempotency_key: nil, request_options: {})
+      #
+      # @param allow_contact_sharing [Boolean] Body param: Whether contacts are shared across profiles (default: false)
+      #
+      # @param allow_template_sharing [Boolean] Body param: Whether templates are shared across profiles (default: false)
+      #
+      # @param billing_model [String, nil] Body param: Billing model: profile, organization, or profile_and_organization (d
+      #
+      # @param description [String, nil] Body param: Profile description (optional)
+      #
+      # @param icon [String, nil] Body param: Profile icon URL (optional)
+      #
+      # @param inherit_contacts [Boolean, nil] Body param: Whether this profile inherits contacts from organization (default: t
+      #
+      # @param inherit_tcr_brand [Boolean, nil] Body param: Whether this profile inherits TCR brand from organization (default:
+      #
+      # @param inherit_tcr_campaign [Boolean, nil] Body param: Whether this profile inherits TCR campaign from organization (defaul
+      #
+      # @param inherit_templates [Boolean, nil] Body param: Whether this profile inherits templates from organization (default:
+      #
+      # @param name [String] Body param: Profile name (required)
+      #
+      # @param short_name [String, nil] Body param: Profile short name/abbreviation (optional)
+      #
+      # @param test_mode [Boolean] Body param: Test mode flag - when true, the operation is simulated without side
+      #
+      # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
+      #
+      # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Sentdm::Models::APIResponseOfProfileDetail]
+      #
+      # @see Sentdm::Models::ProfileCreateParams
+      def create(params = {})
+        parsed, options = Sentdm::ProfileCreateParams.dump_request(params)
+        header_params = {idempotency_key: "idempotency-key"}
+        @client.request(
+          method: :post,
+          path: "v3/profiles",
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: Sentdm::APIResponseOfProfileDetail,
+          options: options
+        )
+      end
+
+      # Retrieves detailed information about a specific sender profile within an
+      # organization.
+      #
+      # @overload retrieve(profile_id, request_options: {})
+      #
+      # @param profile_id [String]
+      # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Sentdm::Models::APIResponseOfProfileDetail]
+      #
+      # @see Sentdm::Models::ProfileRetrieveParams
+      def retrieve(profile_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v3/profiles/%1$s", profile_id],
+          model: Sentdm::APIResponseOfProfileDetail,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Sentdm::Models::ProfileUpdateParams} for more details.
+      #
+      # Updates a profile's configuration and settings. Requires admin role in the
+      # organization. Only provided fields will be updated (partial update).
+      #
+      # @overload update(path_profile_id, allow_contact_sharing: nil, allow_number_change_during_onboarding: nil, allow_template_sharing: nil, billing_model: nil, description: nil, icon: nil, inherit_contacts: nil, inherit_tcr_brand: nil, inherit_tcr_campaign: nil, inherit_templates: nil, name: nil, body_profile_id: nil, sending_phone_number: nil, sending_phone_number_profile_id: nil, sending_whatsapp_number_profile_id: nil, short_name: nil, test_mode: nil, whatsapp_phone_number: nil, idempotency_key: nil, request_options: {})
+      #
+      # @param path_profile_id [String] Path param
+      #
+      # @param allow_contact_sharing [Boolean, nil] Body param: Whether contacts are shared across profiles (optional)
+      #
+      # @param allow_number_change_during_onboarding [Boolean, nil] Body param: Whether number changes are allowed during onboarding (optional)
+      #
+      # @param allow_template_sharing [Boolean, nil] Body param: Whether templates are shared across profiles (optional)
+      #
+      # @param billing_model [String, nil] Body param: Billing model: profile, organization, or profile_and_organization (o
+      #
+      # @param description [String, nil] Body param: Profile description (optional)
+      #
+      # @param icon [String, nil] Body param: Profile icon URL (optional)
+      #
+      # @param inherit_contacts [Boolean, nil] Body param: Whether this profile inherits contacts from organization (optional)
+      #
+      # @param inherit_tcr_brand [Boolean, nil] Body param: Whether this profile inherits TCR brand from organization (optional)
+      #
+      # @param inherit_tcr_campaign [Boolean, nil] Body param: Whether this profile inherits TCR campaign from organization (option
+      #
+      # @param inherit_templates [Boolean, nil] Body param: Whether this profile inherits templates from organization (optional)
+      #
+      # @param name [String, nil] Body param: Profile name (optional)
+      #
+      # @param body_profile_id [String] Body param: Profile ID from route parameter
+      #
+      # @param sending_phone_number [String, nil] Body param: Direct phone number for SMS sending (optional)
+      #
+      # @param sending_phone_number_profile_id [String, nil] Body param: Reference to another profile to use for SMS/Telnyx configuration (op
+      #
+      # @param sending_whatsapp_number_profile_id [String, nil] Body param: Reference to another profile to use for WhatsApp configuration (opti
+      #
+      # @param short_name [String, nil] Body param: Profile short name/abbreviation (optional)
+      #
+      # @param test_mode [Boolean] Body param: Test mode flag - when true, the operation is simulated without side
+      #
+      # @param whatsapp_phone_number [String, nil] Body param: Direct phone number for WhatsApp sending (optional)
+      #
+      # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
+      #
+      # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Sentdm::Models::APIResponseOfProfileDetail]
+      #
+      # @see Sentdm::Models::ProfileUpdateParams
+      def update(path_profile_id, params = {})
+        parsed, options = Sentdm::ProfileUpdateParams.dump_request(params)
+        header_params = {idempotency_key: "idempotency-key"}
+        @client.request(
+          method: :patch,
+          path: ["v3/profiles/%1$s", path_profile_id],
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: Sentdm::APIResponseOfProfileDetail,
+          options: options
+        )
+      end
+
+      # Retrieves all sender profiles within an organization. Profiles represent
+      # different brands, departments, or use cases within an organization, each with
+      # their own messaging configuration.
+      #
+      # @overload list(request_options: {})
+      #
+      # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Sentdm::Models::ProfileListResponse]
+      #
+      # @see Sentdm::Models::ProfileListParams
+      def list(params = {})
+        @client.request(
+          method: :get,
+          path: "v3/profiles",
+          model: Sentdm::Models::ProfileListResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Sentdm::Models::ProfileDeleteParams} for more details.
+      #
+      # Soft deletes a sender profile. The profile will be marked as deleted but data is
+      # retained. Requires admin role in the organization.
+      #
+      # @overload delete(path_profile_id, body_profile_id: nil, test_mode: nil, request_options: {})
+      #
+      # @param path_profile_id [String]
+      #
+      # @param body_profile_id [String] Profile ID from route parameter
+      #
+      # @param test_mode [Boolean] Test mode flag - when true, the operation is simulated without side effects
+      #
+      # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Sentdm::Models::ProfileDeleteParams
+      def delete(path_profile_id, params = {})
+        parsed, options = Sentdm::ProfileDeleteParams.dump_request(params)
+        @client.request(
+          method: :delete,
+          path: ["v3/profiles/%1$s", path_profile_id],
+          headers: {"content-type" => "*/*"},
+          body: parsed,
+          model: NilClass,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Sentdm::Models::ProfileCompleteParams} for more details.
+      #
+      # Final step in profile compliance workflow. Validates all prerequisites (general
+      # data, brand, campaigns), connects profile to Telnyx/WhatsApp, and sets status
+      # based on configuration. The process runs in the background and calls the
+      # provided webhook URL when finished.
+      #
+      #                 Prerequisites:
+      #                 - Profile must be completed
+      #                 - If inheritTcrBrand=false: Profile must have existing brand
+      #                 - If inheritTcrBrand=true: Parent must have existing brand
+      #                 - If TCR application: Must have at least one campaign (own or inherited)
+      #                 - If inheritTcrCampaign=false: Profile should have campaigns
+      #                 - If inheritTcrCampaign=true: Parent must have campaigns
+      #
+      #                 Status Logic:
+      #                 - If both SMS and WhatsApp channels are missing → SUBMITTED
+      #                 - If TCR application and not inheriting brand/campaigns → SUBMITTED
+      #                 - If non-TCR with destination country (IsMain=true) → SUBMITTED
+      #                 - Otherwise → COMPLETED
+      #
+      # @overload complete(profile_id, web_hook_url:, test_mode: nil, idempotency_key: nil, request_options: {})
+      #
+      # @param profile_id [String] Path param: Profile ID from route
+      #
+      # @param web_hook_url [String] Body param: Webhook URL to call when profile completion finishes (success or fai
+      #
+      # @param test_mode [Boolean] Body param: Test mode flag - when true, the operation is simulated without side
+      #
+      # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
+      #
+      # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Object]
+      #
+      # @see Sentdm::Models::ProfileCompleteParams
+      def complete(profile_id, params)
+        parsed, options = Sentdm::ProfileCompleteParams.dump_request(params)
+        header_params = {idempotency_key: "idempotency-key"}
+        @client.request(
+          method: :post,
+          path: ["v3/profiles/%1$s/complete", profile_id],
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: Sentdm::Internal::Type::Unknown,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Sentdm::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/sentdm/resources/templates.rb

@@ -6,77 +6,121 @@ module Sentdm
       # Some parameter documentations has been truncated, see
       # {Sentdm::Models::TemplateCreateParams} for more details.
       #
-      # Creates a new message template for the authenticated customer with comprehensive
-      # template definitions including headers, body, footer, and interactive buttons.
-      # Supports automatic metadata generation using AI (display name, language,
-      # category). Optionally submits the template for WhatsApp review. The customer ID
-      # is extracted from the authentication token.
+      # Creates a new message template with header, body, footer, and buttons. The
+      # template can be submitted for review immediately or saved as draft for later
+      # submission.
       #
-      # @overload create(definition:, category: nil, language: nil, submit_for_review: nil, request_options: {})
+      # @overload create(category: nil, creation_source: nil, definition: nil, language: nil, submit_for_review: nil, test_mode: nil, idempotency_key: nil, request_options: {})
       #
-      # @param definition [Sentdm::Models::TemplateDefinition] Template definition containing header, body, footer, and buttons
+      # @param category [String, nil] Body param: Template category: MARKETING, UTILITY, AUTHENTICATION (optional, aut
       #
-      # @param category [String, nil] The template category (e.g., MARKETING, UTILITY, AUTHENTICATION). Can only be se
+      # @param creation_source [String, nil] Body param: Source of template creation (default: from-api)
       #
-      # @param language [String, nil] The template language code (e.g., en_US, es_ES). Can only be set when creating a
+      # @param definition [Sentdm::Models::TemplateDefinition] Body param: Template definition including header, body, footer, and buttons
       #
-      # @param submit_for_review [Boolean] When false, the template will be saved as draft.
+      # @param language [String, nil] Body param: Template language code (e.g., en_US) (optional, auto-detected if not
+      #
+      # @param submit_for_review [Boolean] Body param: Whether to submit the template for review after creation (default: f
+      #
+      # @param test_mode [Boolean] Body param: Test mode flag - when true, the operation is simulated without side
+      #
+      # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
       #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Sentdm::Models::TemplateResponse]
+      # @return [Sentdm::Models::APIResponseTemplate]
       #
       # @see Sentdm::Models::TemplateCreateParams
-      def create(params)
+      def create(params = {})
         parsed, options = Sentdm::TemplateCreateParams.dump_request(params)
+        header_params = {idempotency_key: "idempotency-key"}
         @client.request(
           method: :post,
-          path: "v2/templates",
-          body: parsed,
-          model: Sentdm::TemplateResponse,
+          path: "v3/templates",
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: Sentdm::APIResponseTemplate,
           options: options
         )
       end
 
-      # Retrieves a specific message template by its unique identifier for the
-      # authenticated customer with comprehensive template definitions including
-      # headers, body, footer, and interactive buttons. The customer ID is extracted
-      # from the authentication token.
+      # Retrieves a specific template by its ID. Returns template details including
+      # name, category, language, status, and definition.
       #
       # @overload retrieve(id, request_options: {})
       #
-      # @param id [String]
+      # @param id [String] Template ID from route parameter
+      #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Sentdm::Models::TemplateResponse]
+      # @return [Sentdm::Models::APIResponseTemplate]
       #
       # @see Sentdm::Models::TemplateRetrieveParams
       def retrieve(id, params = {})
         @client.request(
           method: :get,
-          path: ["v2/templates/%1$s", id],
-          model: Sentdm::TemplateResponse,
+          path: ["v3/templates/%1$s", id],
+          model: Sentdm::APIResponseTemplate,
           options: params[:request_options]
         )
       end
 
-      # Retrieves all message templates available for the authenticated customer with
-      # comprehensive template definitions including headers, body, footer, and
-      # interactive buttons. Supports advanced filtering by search term, status, and
-      # category, plus pagination. The customer ID is extracted from the authentication
-      # token.
+      # Some parameter documentations has been truncated, see
+      # {Sentdm::Models::TemplateUpdateParams} for more details.
+      #
+      # Updates an existing template's name, category, language, definition, or submits
+      # it for review.
+      #
+      # @overload update(id, category: nil, definition: nil, language: nil, name: nil, submit_for_review: nil, test_mode: nil, idempotency_key: nil, request_options: {})
+      #
+      # @param id [String] Path param: Template ID from route parameter
+      #
+      # @param category [String, nil] Body param: Template category: MARKETING, UTILITY, AUTHENTICATION
+      #
+      # @param definition [Sentdm::Models::TemplateDefinition, nil] Body param: Template definition including header, body, footer, and buttons
+      #
+      # @param language [String, nil] Body param: Template language code (e.g., en_US)
+      #
+      # @param name [String, nil] Body param: Template display name
+      #
+      # @param submit_for_review [Boolean] Body param: Whether to submit the template for review after updating (default: f
+      #
+      # @param test_mode [Boolean] Body param: Test mode flag - when true, the operation is simulated without side
+      #
+      # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
+      #
+      # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Sentdm::Models::APIResponseTemplate]
+      #
+      # @see Sentdm::Models::TemplateUpdateParams
+      def update(id, params = {})
+        parsed, options = Sentdm::TemplateUpdateParams.dump_request(params)
+        header_params = {idempotency_key: "idempotency-key"}
+        @client.request(
+          method: :put,
+          path: ["v3/templates/%1$s", id],
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: Sentdm::APIResponseTemplate,
+          options: options
+        )
+      end
+
+      # Retrieves a paginated list of message templates for the authenticated customer.
+      # Supports filtering by status, category, and search term.
       #
       # @overload list(page:, page_size:, category: nil, search: nil, status: nil, request_options: {})
       #
-      # @param page [Integer] The page number (zero-indexed). Default is 0.
+      # @param page [Integer] Page number (1-indexed)
       #
-      # @param page_size [Integer] The number of items per page (1-1000). Default is 100.
+      # @param page_size [Integer]
       #
-      # @param category [String, nil] Optional filter by template category (e.g., MARKETING, UTILITY, AUTHENTICATION)
+      # @param category [String, nil] Optional category filter: MARKETING, UTILITY, AUTHENTICATION
       #
-      # @param search [String, nil] Optional search term to filter templates by name or content
+      # @param search [String, nil] Optional search term for filtering templates
       #
-      # @param status [String, nil] Optional filter by template status (e.g., APPROVED, PENDING, REJECTED, DRAFT)
+      # @param status [String, nil] Optional status filter: APPROVED, PENDING, REJECTED
       #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -87,24 +131,26 @@ module Sentdm
         parsed, options = Sentdm::TemplateListParams.dump_request(params)
         @client.request(
           method: :get,
-          path: "v2/templates",
+          path: "v3/templates",
           query: parsed.transform_keys(page_size: "pageSize"),
           model: Sentdm::Models::TemplateListResponse,
           options: options
         )
       end
 
-      # Deletes a specific message template by its unique identifier for the
-      # authenticated customer with smart deletion strategy. Deletion behavior: - If
-      # template has NO messages: Permanently deleted from database (hard delete). - If
-      # template has messages: Marked as deleted but preserved for message history (soft
-      # delete with snapshot). The template must exist and belong to the authenticated
-      # customer to be deleted successfully. The customer ID is extracted from the
-      # authentication token.
+      # Some parameter documentations has been truncated, see
+      # {Sentdm::Models::TemplateDeleteParams} for more details.
+      #
+      # Deletes a template by ID. Optionally, you can also delete the template from
+      # WhatsApp/Meta by setting delete_from_meta=true.
+      #
+      # @overload delete(id, delete_from_meta: nil, test_mode: nil, request_options: {})
       #
-      # @overload delete(id, request_options: {})
+      # @param id [String] Template ID from route parameter
       #
-      # @param id [String] The unique identifier (GUID) of the resource to retrieve
+      # @param delete_from_meta [Boolean, nil] Whether to also delete the template from WhatsApp/Meta (optional, defaults to fa
+      #
+      # @param test_mode [Boolean] Test mode flag - when true, the operation is simulated without side effects
       #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -112,11 +158,14 @@ module Sentdm
       #
       # @see Sentdm::Models::TemplateDeleteParams
       def delete(id, params = {})
+        parsed, options = Sentdm::TemplateDeleteParams.dump_request(params)
         @client.request(
           method: :delete,
-          path: ["v2/templates/%1$s", id],
+          path: ["v3/templates/%1$s", id],
+          headers: {"content-type" => "*/*"},
+          body: parsed,
           model: NilClass,
-          options: params[:request_options]
+          options: options
         )
       end