rcs 2.0.5.pre.rc.1 → 2.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9bd89608867ec9f9e2576dd7b28eb56d5b168ae22934d5c9f96c23c4ad5f882
-  data.tar.gz: 851780d38f61c39233a279ed413062d354a3227851abcd416858231322bedf10
+  metadata.gz: a9973f0ac25a667d4fc684411e98de98f3a414ea4c851df38c57cb08ecd48f7c
+  data.tar.gz: e33ee21925018bf8472458ce39debdd7324d3522952f2514b0c93d03b91d81de
 SHA512:
-  metadata.gz: 0e0b10f125ff07e74d951b4b254076c8c6b0073432bf5eb8486532426a413af614efe04d22f44b6bb0dbc119f80aa0a3bc77e0141daabfd554af7f70f0360873
-  data.tar.gz: d588d6d094ffe2a7a7f8ec9d5e00384533152293ff2cf1a937d662ac1d15f2c646c2c02ae8a8cb17691efb9f90ef38bc94b542b4a28745c4887618e5dd31f6ab
+  metadata.gz: 862c3ef24cff2a33b06c8b82acd5f760b23ea2895e653676218b47fd7f010ed9648d6d154cc597ba6fdb1ad8b7de71e87677275642699d169b931f1ddb9d2e29
+  data.tar.gz: 1fc9c84cffa9f53caf66be90c4d1aabdc953bb7c2f90bcdfb7ff4673f17bdab89187909f91f4eaabeff3491da5b5892faa0c16a2331a54b8012c6f9d6b6c45ed

data/lib/gemconfig.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Gemconfig
+    VERSION = ""
+    AUTHORS = [""].freeze
+    EMAIL = ""
+    SUMMARY = ""
+    DESCRIPTION = ""
+    HOMEPAGE = "https://github.com/pinnacle-dev/rcs-ruby"
+    SOURCE_CODE_URI = "https://github.com/pinnacle-dev/rcs-ruby"
+    CHANGELOG_URI = "https://github.com/pinnacle-dev/rcs-ruby/blob/master/CHANGELOG.md"
+  end
+end

data/lib/rcs/audiences/client.rb

@@ -0,0 +1,347 @@
+# frozen_string_literal: true
+
+require_relative "../../requests"
+require_relative "types/audiences_get_response"
+require_relative "../types/audience_count_only"
+require_relative "../types/delete_audience_response"
+require "async"
+
+module Pinnacle
+  class AudiencesClient
+    # @return [Pinnacle::RequestClient]
+    attr_reader :request_client
+
+    # @param request_client [Pinnacle::RequestClient]
+    # @return [Pinnacle::AudiencesClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+
+    # Retrieve an audience by ID with optional pagination.
+    #
+    # @param id [String] Audience ID. This identifier is a string that always begins with the prefix
+    #  `aud_`, for example: `aud_abc123`.
+    # @param page [Integer] Page number. If provided with or without limit, returns paginated contacts.
+    # @param limit [Integer] Items per page. If provided with or without page, returns paginated contacts.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::AudienceWithPagination, Pinnacle::Types::AudienceCountOnly]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.audiences.get(id: "aud_abc123")
+    def get(id:, page: nil, limit: nil, request_options: nil)
+      response = @request_client.conn.get do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        req.params = {
+          **(request_options&.additional_query_parameters || {}),
+          "id": id,
+          "page": page,
+          "limit": limit
+        }.compact
+        unless request_options.nil? || request_options&.additional_body_parameters.nil?
+          req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+        end
+        req.url "#{@request_client.get_url(request_options: request_options)}/audiences"
+      end
+      Pinnacle::Audiences::Types::AudiencesGetResponse.from_json(json_object: response.body)
+    end
+
+    # Create a new audience with optional initial contacts. Phone numbers that don't
+    #  exist will be auto-created as contacts.
+    #
+    # @param name [String] Audience name.
+    # @param description [String] Audience description.
+    # @param contacts [Array<String>] Optional array of phone numbers (E.164 format) or contact IDs.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::AudienceCountOnly]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.audiences.create(name: "Marketing Campaign Q1", description: "Contacts for Q1 marketing push")
+    def create(name:, description: nil, contacts: nil, request_options: nil)
+      response = @request_client.conn.post do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        unless request_options.nil? || request_options&.additional_query_parameters.nil?
+          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+        end
+        req.body = {
+          **(request_options&.additional_body_parameters || {}),
+          name: name,
+          description: description,
+          contacts: contacts
+        }.compact
+        req.url "#{@request_client.get_url(request_options: request_options)}/audiences"
+      end
+      Pinnacle::Types::AudienceCountOnly.from_json(json_object: response.body)
+    end
+
+    # Permanently delete an audience and all its contact associations.
+    #  Note: This will NOT delete the contacts themselves, only the audience and its
+    #  memberships.
+    #
+    # @param id [String] Audience ID. This identifier is a string that always begins with the prefix
+    #  `aud_`, for example: `aud_abc123`.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::DeleteAudienceResponse]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.audiences.delete(id: "aud_abc123")
+    def delete(id:, request_options: nil)
+      response = @request_client.conn.delete do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        req.params = { **(request_options&.additional_query_parameters || {}), "id": id }.compact
+        unless request_options.nil? || request_options&.additional_body_parameters.nil?
+          req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+        end
+        req.url "#{@request_client.get_url(request_options: request_options)}/audiences"
+      end
+      Pinnacle::Types::DeleteAudienceResponse.from_json(json_object: response.body)
+    end
+
+    # Update audience metadata. This endpoint does NOT modify contacts.
+    #  To add or remove contacts, use the [Add
+    #  Contacts](/api-reference/audiences/add-contacts) or [Remove
+    #  Contacts](/api-reference/audiences/remove-contacts) endpoints.
+    #
+    # @param id [String] Audience ID to update. This identifier is a string that always begins with the
+    #  prefix `aud_`, for example: `aud_abc123`.
+    # @param name [String] New audience name.
+    # @param description [String] New audience description.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::AudienceCountOnly]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.audiences.update(
+    #    id: "aud_abc123",
+    #    name: "Updated Audience Name",
+    #    description: "New description"
+    #  )
+    def update(id:, name: nil, description: nil, request_options: nil)
+      response = @request_client.conn.patch do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        unless request_options.nil? || request_options&.additional_query_parameters.nil?
+          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+        end
+        req.body = {
+          **(request_options&.additional_body_parameters || {}),
+          id: id,
+          name: name,
+          description: description
+        }.compact
+        req.url "#{@request_client.get_url(request_options: request_options)}/audiences"
+      end
+      Pinnacle::Types::AudienceCountOnly.from_json(json_object: response.body)
+    end
+  end
+
+  class AsyncAudiencesClient
+    # @return [Pinnacle::AsyncRequestClient]
+    attr_reader :request_client
+
+    # @param request_client [Pinnacle::AsyncRequestClient]
+    # @return [Pinnacle::AsyncAudiencesClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+
+    # Retrieve an audience by ID with optional pagination.
+    #
+    # @param id [String] Audience ID. This identifier is a string that always begins with the prefix
+    #  `aud_`, for example: `aud_abc123`.
+    # @param page [Integer] Page number. If provided with or without limit, returns paginated contacts.
+    # @param limit [Integer] Items per page. If provided with or without page, returns paginated contacts.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::AudienceWithPagination, Pinnacle::Types::AudienceCountOnly]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.audiences.get(id: "aud_abc123")
+    def get(id:, page: nil, limit: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.get do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "id": id,
+            "page": page,
+            "limit": limit
+          }.compact
+          unless request_options.nil? || request_options&.additional_body_parameters.nil?
+            req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          req.url "#{@request_client.get_url(request_options: request_options)}/audiences"
+        end
+        Pinnacle::Audiences::Types::AudiencesGetResponse.from_json(json_object: response.body)
+      end
+    end
+
+    # Create a new audience with optional initial contacts. Phone numbers that don't
+    #  exist will be auto-created as contacts.
+    #
+    # @param name [String] Audience name.
+    # @param description [String] Audience description.
+    # @param contacts [Array<String>] Optional array of phone numbers (E.164 format) or contact IDs.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::AudienceCountOnly]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.audiences.create(name: "Marketing Campaign Q1", description: "Contacts for Q1 marketing push")
+    def create(name:, description: nil, contacts: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.post do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = {
+            **(request_options&.additional_body_parameters || {}),
+            name: name,
+            description: description,
+            contacts: contacts
+          }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/audiences"
+        end
+        Pinnacle::Types::AudienceCountOnly.from_json(json_object: response.body)
+      end
+    end
+
+    # Permanently delete an audience and all its contact associations.
+    #  Note: This will NOT delete the contacts themselves, only the audience and its
+    #  memberships.
+    #
+    # @param id [String] Audience ID. This identifier is a string that always begins with the prefix
+    #  `aud_`, for example: `aud_abc123`.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::DeleteAudienceResponse]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.audiences.delete(id: "aud_abc123")
+    def delete(id:, request_options: nil)
+      Async do
+        response = @request_client.conn.delete do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          req.params = { **(request_options&.additional_query_parameters || {}), "id": id }.compact
+          unless request_options.nil? || request_options&.additional_body_parameters.nil?
+            req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          req.url "#{@request_client.get_url(request_options: request_options)}/audiences"
+        end
+        Pinnacle::Types::DeleteAudienceResponse.from_json(json_object: response.body)
+      end
+    end
+
+    # Update audience metadata. This endpoint does NOT modify contacts.
+    #  To add or remove contacts, use the [Add
+    #  Contacts](/api-reference/audiences/add-contacts) or [Remove
+    #  Contacts](/api-reference/audiences/remove-contacts) endpoints.
+    #
+    # @param id [String] Audience ID to update. This identifier is a string that always begins with the
+    #  prefix `aud_`, for example: `aud_abc123`.
+    # @param name [String] New audience name.
+    # @param description [String] New audience description.
+    # @param request_options [Pinnacle::RequestOptions]
+    # @return [Pinnacle::Types::AudienceCountOnly]
+    # @example
+    #  api = Pinnacle::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: Pinnacle::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.audiences.update(
+    #    id: "aud_abc123",
+    #    name: "Updated Audience Name",
+    #    description: "New description"
+    #  )
+    def update(id:, name: nil, description: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.patch do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = {
+            **(request_options&.additional_body_parameters || {}),
+            id: id,
+            name: name,
+            description: description
+          }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/audiences"
+        end
+        Pinnacle::Types::AudienceCountOnly.from_json(json_object: response.body)
+      end
+    end
+  end
+end

data/lib/rcs/audiences/contacts/client.rb

@@ -0,0 +1,177 @@
+# frozen_string_literal: true
+
+require_relative "../../../requests"
+require_relative "../../types/audience_count_only"
+require "async"
+
+module Pinnacle
+  module Audiences
+    class ContactsClient
+      # @return [Pinnacle::RequestClient]
+      attr_reader :request_client
+
+      # @param request_client [Pinnacle::RequestClient]
+      # @return [Pinnacle::Audiences::ContactsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+
+      # Remove contacts from an existing audience. This operation is idempotent.
+      #  - Only removes contacts that exist in the audience
+      #  - Contacts not in the audience are ignored
+      #
+      # @param id [String] Audience ID. This identifier is a string that always begins with the prefix
+      #  `aud_`, for example: `aud_abc123`.
+      # @param contacts [Array<String>] Array of phone numbers (E.164 format) or contact IDs. <br><br>
+      #  **Limit:** 1 min
+      # @param request_options [Pinnacle::RequestOptions]
+      # @return [Pinnacle::Types::AudienceCountOnly]
+      # @example
+      #  api = Pinnacle::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Pinnacle::Environment::DEFAULT,
+      #    api_key: "YOUR_API_KEY"
+      #  )
+      #  api.audiences.contacts.remove(id: "aud_abc123", contacts: ["+12125551234", "co_def456"])
+      def remove(id:, contacts:, request_options: nil)
+        response = @request_client.conn.delete do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = { **(request_options&.additional_body_parameters || {}), id: id, contacts: contacts }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/audiences/contacts"
+        end
+        Pinnacle::Types::AudienceCountOnly.from_json(json_object: response.body)
+      end
+
+      # Add contacts to an existing audience. This operation is additive and idempotent.
+      #  - Phone numbers that don't exist will be auto-created as contacts
+      #  - Duplicate adds are ignored
+      #  - Contacts already in the audience are ignored
+      #
+      # @param id [String] Audience ID. This identifier is a string that always begins with the prefix
+      #  `aud_`, for example: `aud_abc123`.
+      # @param contacts [Array<String>] Array of phone numbers (E.164 format) or contact IDs. <br><br>
+      #  **Limit:** 1 min
+      # @param request_options [Pinnacle::RequestOptions]
+      # @return [Pinnacle::Types::AudienceCountOnly]
+      # @example
+      #  api = Pinnacle::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Pinnacle::Environment::DEFAULT,
+      #    api_key: "YOUR_API_KEY"
+      #  )
+      #  api.audiences.contacts.add(id: "aud_abc123", contacts: ["+12125551234", "co_def456", "+13105551234"])
+      def add(id:, contacts:, request_options: nil)
+        response = @request_client.conn.patch do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = { **(request_options&.additional_body_parameters || {}), id: id, contacts: contacts }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/audiences/contacts"
+        end
+        Pinnacle::Types::AudienceCountOnly.from_json(json_object: response.body)
+      end
+    end
+
+    class AsyncContactsClient
+      # @return [Pinnacle::AsyncRequestClient]
+      attr_reader :request_client
+
+      # @param request_client [Pinnacle::AsyncRequestClient]
+      # @return [Pinnacle::Audiences::AsyncContactsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+
+      # Remove contacts from an existing audience. This operation is idempotent.
+      #  - Only removes contacts that exist in the audience
+      #  - Contacts not in the audience are ignored
+      #
+      # @param id [String] Audience ID. This identifier is a string that always begins with the prefix
+      #  `aud_`, for example: `aud_abc123`.
+      # @param contacts [Array<String>] Array of phone numbers (E.164 format) or contact IDs. <br><br>
+      #  **Limit:** 1 min
+      # @param request_options [Pinnacle::RequestOptions]
+      # @return [Pinnacle::Types::AudienceCountOnly]
+      # @example
+      #  api = Pinnacle::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Pinnacle::Environment::DEFAULT,
+      #    api_key: "YOUR_API_KEY"
+      #  )
+      #  api.audiences.contacts.remove(id: "aud_abc123", contacts: ["+12125551234", "co_def456"])
+      def remove(id:, contacts:, request_options: nil)
+        Async do
+          response = @request_client.conn.delete do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers = {
+          **(req.headers || {}),
+          **@request_client.get_headers,
+          **(request_options&.additional_headers || {})
+            }.compact
+            unless request_options.nil? || request_options&.additional_query_parameters.nil?
+              req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+            end
+            req.body = { **(request_options&.additional_body_parameters || {}), id: id, contacts: contacts }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/audiences/contacts"
+          end
+          Pinnacle::Types::AudienceCountOnly.from_json(json_object: response.body)
+        end
+      end
+
+      # Add contacts to an existing audience. This operation is additive and idempotent.
+      #  - Phone numbers that don't exist will be auto-created as contacts
+      #  - Duplicate adds are ignored
+      #  - Contacts already in the audience are ignored
+      #
+      # @param id [String] Audience ID. This identifier is a string that always begins with the prefix
+      #  `aud_`, for example: `aud_abc123`.
+      # @param contacts [Array<String>] Array of phone numbers (E.164 format) or contact IDs. <br><br>
+      #  **Limit:** 1 min
+      # @param request_options [Pinnacle::RequestOptions]
+      # @return [Pinnacle::Types::AudienceCountOnly]
+      # @example
+      #  api = Pinnacle::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Pinnacle::Environment::DEFAULT,
+      #    api_key: "YOUR_API_KEY"
+      #  )
+      #  api.audiences.contacts.add(id: "aud_abc123", contacts: ["+12125551234", "co_def456", "+13105551234"])
+      def add(id:, contacts:, request_options: nil)
+        Async do
+          response = @request_client.conn.patch do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers = {
+          **(req.headers || {}),
+          **@request_client.get_headers,
+          **(request_options&.additional_headers || {})
+            }.compact
+            unless request_options.nil? || request_options&.additional_query_parameters.nil?
+              req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+            end
+            req.body = { **(request_options&.additional_body_parameters || {}), id: id, contacts: contacts }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/audiences/contacts"
+          end
+          Pinnacle::Types::AudienceCountOnly.from_json(json_object: response.body)
+        end
+      end
+    end
+  end
+end

data/lib/rcs/audiences/types/audiences_get_response.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "../../types/audience_with_pagination"
+require_relative "../../types/audience_count_only"
+
+module Pinnacle
+  module Audiences
+    module Types
+      class AudiencesGetResponse
+        # Deserialize a JSON object to an instance of AudiencesGetResponse
+        #
+        # @param json_object [String]
+        # @return [Pinnacle::Audiences::Types::AudiencesGetResponse]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          begin
+            Pinnacle::Types::AudienceWithPagination.validate_raw(obj: struct)
+            return Pinnacle::Types::AudienceWithPagination.from_json(json_object: struct) unless struct.nil?
+
+            return nil
+          rescue StandardError
+            # noop
+          end
+          begin
+            Pinnacle::Types::AudienceCountOnly.validate_raw(obj: struct)
+            return Pinnacle::Types::AudienceCountOnly.from_json(json_object: struct) unless struct.nil?
+
+            return nil
+          rescue StandardError
+            # noop
+          end
+          struct
+        end
+
+        # Leveraged for Union-type generation, validate_raw attempts to parse the given
+        #  hash and check each fields type against the current object's property
+        #  definitions.
+        #
+        # @param obj [Object]
+        # @return [Void]
+        def self.validate_raw(obj:)
+          begin
+            return Pinnacle::Types::AudienceWithPagination.validate_raw(obj: obj)
+          rescue StandardError
+            # noop
+          end
+          begin
+            return Pinnacle::Types::AudienceCountOnly.validate_raw(obj: obj)
+          rescue StandardError
+            # noop
+          end
+          raise("Passed value matched no type within the union, validation failed.")
+        end
+      end
+    end
+  end
+end