rcs 2.0.0 → 2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b62f856fc547382d4d1cf18aa5d06d9746cc02480ed3890318a707c2fba8794
-  data.tar.gz: 9403e66a841948733781b0eddade27c3108cf169e13af030edfe309fea50b530
+  metadata.gz: 9ae139d400bbfa1ab360ba9c8330f3cdf286e7ef16772032ff9dba8be4b54f21
+  data.tar.gz: f2041515877561cffa19ad82eda057813788dd59f5e6423b89005197085f98ec
 SHA512:
-  metadata.gz: 1fcb90da1af1f5cbbc8c429f225199b402f3738455295a21570169cd5a2c77464f57378e90d0bed2f297980d18bcd6c6dac92df7a842f96b8e695c4d05f14592
-  data.tar.gz: 4553c27971714a7fbd92a07002e0e75248463a4dacb30a89a2f9eb570599795bcebba4764f6234c84832b8632b56cf7408ceebebf9cbf4438721a3c1650ac359
+  metadata.gz: 9923fb9be738fd30e395689c60cddd25046dbc073bdf1af1792cb2260e7e43bdd1da99d9e74a7c8fd344d3c34aba7375cdcbb1749e8d35bad1779e759f71c574
+  data.tar.gz: fa778ca98424e492675eb4906a908b97dabeacfa4c5fe72c0f79d88ae562e00a838b94a1cafb3902bf940a0e0697cc467d77a476b45a91d50fb86e8913938954

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,173 @@
+# 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 (minimum 1 item).
+      # @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 (minimum 1 item).
+      # @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 (minimum 1 item).
+      # @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 (minimum 1 item).
+      # @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