apimatic-apollo-sdk 0.0.1

data/lib/apollo_rest_api/apis/analytics_api.rb

@@ -0,0 +1,65 @@
+# apollo_rest_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module ApolloRestApi
+  # AnalyticsApi
+  class AnalyticsApi < BaseApi
+    # This endpoint doesn't consume Apollo credits. Learn more about [API
+    # pricing and credits](https://docs.apollo.io/docs/api-pricing).
+    # Use the Query Analytics Report endpoint to programmatically query <a
+    # href="https://knowledge.apollo.io/hc/en-us/articles/33574373762317-Analyti
+    # cs-Overview" target="_blank">Apollo analytics</a> and retrieve aggregated
+    # sales activity data for your team.<br><br>This endpoint accepts a flexible
+    # payload specifying which metrics to measure, how to group and filter
+    # results, and which date range to apply — returning the same data that
+    # powers Apollo's built-in Analytics dashboards. <br><br>Three query modes
+    # are supported: flat totals (no <code>group_by</code>), grouped by one
+    # dimension such as user or sequence, and pivot cross-tab (one
+    # <code>group_by</code> dimension as rows + one <code>pivot_group_by</code>
+    # dimension as columns). Each array supports a maximum of one entry.<br><br>
+    # <strong>Authentication:</strong> Requires an Apollo API key with access to
+    # the <code>api/v1/reports/sync_report</code> API. When creating or editing
+    # an API key in Apollo Settings, open the <strong>APIs</strong> tab and
+    # select <code>api/v1/reports/sync_report</code> from the list. Check out <a
+    # href="https://docs.apollo.io/docs/create-api-key">Create an API Key</a>
+    # for detailed instructions.<br><br><strong>Tip:</strong> The easiest way to
+    # discover valid metric and group_by combinations is to build a report
+    # interactively at <a href="https://app.apollo.io/#/analytics/reports/new"
+    # target="_blank">Apollo Analytics → Start from scratch</a>, then replicate
+    # that configuration in your API request.
+    # @param [ReportsSyncReportRequest] body Required parameter: TODO: type
+    # description here
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def sync_report(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/reports/sync_report',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body)
+                                .is_required(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Or.new('bearerAuth', 'apiKey')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ReportsSyncReportResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 '400',
+                                 ReportsSyncReport400ErrorException)
+                    .local_error('401',
+                                 '401',
+                                 APIException)
+                    .local_error('422',
+                                 '422',
+                                 NeedMasterApiKeyException)
+                    .local_error('429',
+                                 '429',
+                                 ReportsSyncReport429ErrorException))
+        .execute
+    end
+  end
+end

data/lib/apollo_rest_api/apis/api.rb

@@ -0,0 +1,45 @@
+# apollo_rest_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module ApolloRestApi
+  # Api
+  class Api < BaseApi
+    # This endpoint doesn't consume Apollo credits. Learn more about [API
+    # pricing and credits](https://docs.apollo.io/docs/api-pricing).
+    # <a
+    # href="https://knowledge.apollo.io/hc/en-us/articles/4409130537101-Add-Mana
+    # ge-and-Deactivate-Users" target="_blank">Users</a> are the people who use
+    # your Apollo workspace.<br><br>Use the Get Current User Profile endpoint to
+    # retrieve the authenticated profile of the person who owns the API key
+    # being used.<br><br>By default, the endpoint returns the user's identity
+    # fields. Set the `include_credit_usage` query parameter to `true` to also
+    # return the user's and team's credit usage and remaining credit
+    # balances.<br><br>If you call this endpoint without valid access
+    # credentials, you receive a `401` response.
+    # @param [TrueClass | FalseClass] include_credit_usage Optional parameter:
+    # Set to `true` to include credit usage and remaining credit details (lead,
+    # direct dial, export, AI, and power-up credits) in the response. Accepts
+    # boolean (`true`/`false`) or string (`"true"`/`"false"`) values. Defaults
+    # to `false`. <br><br>Example: `true`
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def get_current_user_profile(include_credit_usage: false)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/users/api_profile',
+                                     Server::DEFAULT)
+                   .query_param(new_parameter(include_credit_usage, key: 'include_credit_usage'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Or.new('bearerAuth', 'apiKey')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(UsersApiProfileResponse.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('401',
+                                 '401',
+                                 APIException))
+        .execute
+    end
+  end
+end

data/lib/apollo_rest_api/apis/base_api.rb

@@ -0,0 +1,67 @@
+# apollo_rest_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module ApolloRestApi
+  # BaseApi.
+  class BaseApi
+    include CoreLibrary
+    attr_accessor :config, :http_call_back
+
+    def self.user_agent
+      'Ruby-SDK/0.0.1 (OS: {os-info}, Engine: {engine}/{engine-version})'
+    end
+
+    def self.user_agent_parameters
+      {
+        '{engine}' => { 'value' => RUBY_ENGINE, 'encode' => false },
+        '{engine-version}' => { 'value' => RUBY_ENGINE_VERSION, 'encode' => false },
+        '{os-info}' => { 'value' => RUBY_PLATFORM, 'encode' => false }
+      }
+    end
+
+    GLOBAL_ERRORS = {
+      'default' => ErrorCase.new
+                            .error_message('HTTP response not OK.')
+                            .exception_type(APIException)
+    }.freeze
+
+    # Initialization constructor.
+    # @param [GlobalConfiguration] global_configuration The instance of GlobalConfiguration.
+    def initialize(global_configuration)
+      @global_configuration = global_configuration
+      @config = @global_configuration.client_configuration
+      @http_call_back = @config.http_callback
+      @api_call = ApiCall.new(@global_configuration)
+    end
+
+    # Creates a new instance of the request builder.
+    # @param [String] http_method The HTTP method to use in the request.
+    # @param [String] path The endpoint path to use in the request.
+    # @param [String] server The server to extract the base uri for the request.
+    # @return [RequestBuilder] The instance of RequestBuilder.
+    def new_request_builder(http_method, path, server)
+      RequestBuilder.new
+                    .http_method(http_method)
+                    .path(path)
+                    .server(server)
+    end
+
+    # Creates a new instance of the response handler.
+    # @return [ResponseHandler] The instance of ResponseHandler.
+    def new_response_handler
+      ResponseHandler.new
+    end
+
+    # Creates a new instance of the parameter.
+    # @param [String|optional] key The key of the parameter.
+    # @param [Object] value The value of the parameter.
+    # @return [Parameter] The instance of Parameter.
+    def new_parameter(value, key: nil)
+      Parameter.new
+               .key(key)
+               .value(value)
+    end
+  end
+end

data/lib/apollo_rest_api/apis/calls_api.rb

@@ -0,0 +1,354 @@
+# apollo_rest_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module ApolloRestApi
+  # CallsApi
+  class CallsApi < BaseApi
+    # This endpoint doesn't consume Apollo credits. Learn more about [API
+    # pricing and credits](https://docs.apollo.io/docs/api-pricing).
+    # Use the Search for Calls endpoint to find calls that your team has made or
+    #  received using <a
+    # href="https://knowledge.apollo.io/hc/en-us/articles/4409140527757-Dialer-O
+    # verview" target="_blank">the dialer</a> on Apollo.<br><br>This endpoint
+    # requires a master API key. If you call the endpoint without a master key,
+    # you receive a `403`  response. Check out <a
+    # href="https://docs.apollo.io/docs/create-api-key">Create an API Key</a> to
+    # learn how to create a master API key.
+    # @param [Date] date_range_max Optional parameter: Set the upper bound of
+    # the date range you want to search. <br><br>Use this parameter in
+    # combination with the `date_range[min]` parameter. This date should fall
+    # after the `date_range[min]` date. <br><br>The date should be formatted as
+    # `YYYY-MM-DD`. <br><br>Example: `2025-06-12`
+    # @param [Date] date_range_min Optional parameter: Set the lower bound of
+    # the date range you want to search. <br><br>Use this parameter in
+    # combination with the `date_range[max]` parameter. This date should fall
+    # before the `date_range[max]` date. <br><br>The date should be formatted as
+    # `YYYY-MM-DD`. <br><br>Example: `2025-04-01`
+    # @param [Integer] duration_max Optional parameter: Set the upper bound for
+    # the call duration you want to search. The duration should be seconds, not
+    # minutes or hours. <br><br>Use this parameter in combination with the
+    # `duration[min]` parameter. This number should be larger than
+    # `duration[min]`. <br><br>Example: `180`
+    # @param [Integer] duration_min Optional parameter: Set the lower bound for
+    # the call duration you want to search. The duration should be seconds, not
+    # minutes or hours. <br><br>Use this parameter in combination with the
+    # `duration[max]` parameter. This number should be smallerr than
+    # `duration[min]`. <br><br>Example: `30`
+    # @param [String] inbound Optional parameter: Search for calls based on
+    # whether they were `incoming` (the prospect called your team) or `outgoing`
+    # (your team called the prospect).
+    # @param [Array[String]] user_ids Optional parameter: Find calls that
+    # included specific users in your team's Apollo account. You can add
+    # multiple users. <br><br>Use the <a
+    # href="https://docs.apollo.io/reference/get-a-list-of-users"
+    # target="_blank">Get a List of Users endpoint</a> to retrieve IDs for all
+    # of the users within your Apollo account. <br><br>Example:
+    # `67e33d527de088000daa60c4`
+    # @param [Array[String]] contact_label_ids Optional parameter: Find calls
+    # that included specific contacts. You can add multiple contacts. <br><br>In
+    # Apollo terminology, a contact is a person that your team has explicitly
+    # added to your database. <br><br>Use the <a
+    # href="https://docs.apollo.io/reference/get-a-list-of-users"
+    # target="_blank">Get a List of Users endpoint</a> to retrieve IDs for all
+    # of the users within your Apollo account. <br><br>Example:
+    # `67e33d527de088000daa60c4` 6708415f59d9c70001b2f852
+    # @param [Array[String]] phone_call_purpose_ids Optional parameter: Filter
+    # calls based on their purpose. <br><br>Call purposes are unique to your
+    # team's Apollo account. When you use the <b>Purpose</b> search filter for
+    # calls in the Apollo product, you can find the corresponding call purpose
+    # ID in the URL. <br><br>Example: `6095a710bd01d100a506d4cf`
+    # @param [Array[String]] phone_call_outcome_ids Optional parameter: Filter
+    # calls based on their outcome. <br><br>Call outcomes are unique to your
+    # team's Apollo account. When you use the <b>Disposition</b> search filter
+    # for calls in the Apollo product, you can find the corresponding call
+    # outcome ID in the URL. <br><br>Example: `6095a710bd01d100a506d4c5`
+    # @param [String] q_keywords Optional parameter: Add keywords to narrow the
+    # search of the calls in your team's Apollo account. <br><br>Example:
+    # `marketing conference attendees`
+    # @param [String] page Optional parameter: The page number of the Apollo
+    # data that you want to retrieve. <br><br>Use this parameter in combination
+    # with the `per_page` parameter to make search results for navigable and
+    # improve the performance of the endpoint. <br><br>Example: `4`
+    # @param [String] per_page Optional parameter: The number of search results
+    # that should be returned for each page. Limiting the number of results per
+    # page improves the endpoint's performance. <br><br>Use the page parameter
+    # to search the different pages of data. <br><br>Example: `10`
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def get_phone_callssearch(date_range_max: nil,
+                              date_range_min: nil,
+                              duration_max: nil,
+                              duration_min: nil,
+                              inbound: nil,
+                              user_ids: nil,
+                              contact_label_ids: nil,
+                              phone_call_purpose_ids: nil,
+                              phone_call_outcome_ids: nil,
+                              q_keywords: nil,
+                              page: nil,
+                              per_page: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/phone_calls/search',
+                                     Server::DEFAULT)
+                   .query_param(new_parameter(date_range_max, key: 'date_range[max]'))
+                   .query_param(new_parameter(date_range_min, key: 'date_range[min]'))
+                   .query_param(new_parameter(duration_max, key: 'duration[max]'))
+                   .query_param(new_parameter(duration_min, key: 'duration[min]'))
+                   .query_param(new_parameter(inbound, key: 'inbound'))
+                   .query_param(new_parameter(user_ids, key: 'user_ids[]'))
+                   .query_param(new_parameter(contact_label_ids, key: 'contact_label_ids[]'))
+                   .query_param(new_parameter(phone_call_purpose_ids, key: 'phone_call_purpose_ids[]'))
+                   .query_param(new_parameter(phone_call_outcome_ids, key: 'phone_call_outcome_ids[]'))
+                   .query_param(new_parameter(q_keywords, key: 'q_keywords'))
+                   .query_param(new_parameter(page, key: 'page'))
+                   .query_param(new_parameter(per_page, key: 'per_page'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Or.new('bearerAuth', 'apiKey')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:dynamic_deserializer))
+                    .is_api_response(true)
+                    .local_error('401',
+                                 '401',
+                                 APIException)
+                    .local_error('403',
+                                 'Forbidden',
+                                 APIException))
+        .execute
+    end
+
+    # This endpoint doesn't consume Apollo credits. Learn more about [API
+    # pricing and credits](https://docs.apollo.io/docs/api-pricing).
+    # Use the Create Call Records endpoint to log calls in Apollo that were made
+    # using outside systems such as Orum or Nooks. This endpoint can only be
+    # used create call records, not to dial prospects.<br><br>This endpoint
+    # requires a master API key. If you call the endpoint without a master key,
+    # you receive a `403` response. Check out <a
+    # href="https://docs.apollo.io/docs/create-api-key">Create an API Key</a> to
+    # learn how to create a master key.
+    # @param [TrueClass | FalseClass] logged Optional parameter: Set to `true`
+    # if you want to create an individual record for the phone call in Apollo.
+    # @param [Array[String]] user_id Optional parameter: Designate the caller in
+    # your team's Apollo account. <br><br>Use the <a
+    # href="https://docs.apollo.io/reference/get-a-list-of-users"
+    # target="_blank">Get a List of Users endpoint</a> to retrieve IDs for all
+    # of the users within your Apollo account. <br><br>Example:
+    # `67e33d527de088000daa60c4`
+    # @param [String] contact_id Optional parameter: Designate the contact that
+    # was called. <br><br>Use the <a
+    # href="https://docs.apollo.io/reference/search-for-contacts#/"
+    # target="_blank">Search for Contacts endpoint</a> to retrieve IDs for all
+    # of the contacts within your Apollo account. <br><br>Example:
+    # `66e34b81740c50074e3d1bd4`
+    # @param [String] account_id Optional parameter: Associate the call with an
+    # account. <br><br>Use the <a
+    # href="https://docs.apollo.io/reference/search-for-accounts#/"
+    # target="_blank">Search for Accounts endpoint</a> to retrieve IDs for all
+    # of the accounts within your Apollo account. <br><br>Example:
+    # `66e9abf95ac32901b20d1a0d`
+    # @param [String] to_number Optional parameter: The phone number that you
+    # dialed. <br><br>Example: `5555550164`
+    # @param [String] from_number Optional parameter: The phone number that
+    # dialed you. <br><br>Example: `5555550164`
+    # @param [String] status Optional parameter: The status of the phone call.
+    # Possible values include: <ul> <li>`queued`</li> <li>`ringing`</li>
+    # <li>`in-progress`</li> <li>`completed`</li> <li>`no_answer`</li>
+    # <li>`failed`</li> <li>`busy`</li></ul>
+    # @param [DateTime] start_time Optional parameter: The time when the call
+    # started. <br><br>Your entry should adhere to the ISO 8601 date-time
+    # format. Apollo uses Greenwich Mean Time (GMT) by default. If you do not
+    # account for time zone differences, you could add a start time that falls
+    # on a different day than you intended. <br><br>The value you enter can
+    # either adhere to GMT, or you can adjust the time manually by specifiying
+    # in hours and minutes how much you want to offset GMT. <br><br>Example:
+    # `2025-02-15T08:10:30Z`; `2025-03-25T10:15:30+05:00Z`
+    # @param [DateTime] end_time Optional parameter: The time when the call
+    # ended. <br><br>Your entry should adhere to the ISO 8601 date-time format.
+    # Apollo uses Greenwich Mean Time (GMT) by default. If you do not account
+    # for time zone differences, you could add a end time that falls on a
+    # different day than you intended. <br><br>The value you enter can either
+    # adhere to GMT, or you can adjust the time manually by specifiying in hours
+    # and minutes how much you want to offset GMT. <br><br>Example:
+    # `2025-05-15T08:10:30Z`; `2025-05-25T10:15:30+05:00Z`
+    # @param [Integer] duration Optional parameter: The duration of the call in
+    # seconds. Do not enter minutes. <br><br>Examples: `120`; `205`
+    # @param [String] phone_call_purpose_id Optional parameter: Assign a call
+    # purpose to the record. <br><br>Call purposes are unique to your team's
+    # Apollo account. When you use the <b>Purpose</b> search filter for calls in
+    # the Apollo product, you can find the corresponding call purpose ID in the
+    # URL. <br><br>Examples: `6095a710bd01d100a506d4cd`
+    # @param [String] phone_call_outcome_id Optional parameter: Assign a call
+    # outcome to the record. <br><br>Call outcomes are unique to your team's
+    # Apollo account. When you use the <b>Disposition</b> search filter for
+    # calls in the Apollo product, you can find the corresponding call outcome
+    # ID in the URL. <br><br>Examples: `6095a710bd01d100a506d4c5`
+    # @param [String] note Optional parameter: Add a note to the call record.
+    # <br><br>Example: `This lead is interested in learning more about our new
+    # product line.`
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def phonecalls_create(logged: nil,
+                          user_id: nil,
+                          contact_id: nil,
+                          account_id: nil,
+                          to_number: nil,
+                          from_number: nil,
+                          status: nil,
+                          start_time: nil,
+                          end_time: nil,
+                          duration: nil,
+                          phone_call_purpose_id: nil,
+                          phone_call_outcome_id: nil,
+                          note: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/phone_calls',
+                                     Server::DEFAULT)
+                   .query_param(new_parameter(logged, key: 'logged'))
+                   .query_param(new_parameter(user_id, key: 'user_id[]'))
+                   .query_param(new_parameter(contact_id, key: 'contact_id'))
+                   .query_param(new_parameter(account_id, key: 'account_id'))
+                   .query_param(new_parameter(to_number, key: 'to_number'))
+                   .query_param(new_parameter(from_number, key: 'from_number'))
+                   .query_param(new_parameter(status, key: 'status'))
+                   .query_param(new_parameter(start_time, key: 'start_time'))
+                   .query_param(new_parameter(end_time, key: 'end_time'))
+                   .query_param(new_parameter(duration, key: 'duration'))
+                   .query_param(new_parameter(phone_call_purpose_id, key: 'phone_call_purpose_id'))
+                   .query_param(new_parameter(phone_call_outcome_id, key: 'phone_call_outcome_id'))
+                   .query_param(new_parameter(note, key: 'note'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Or.new('bearerAuth', 'apiKey')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:dynamic_deserializer))
+                    .is_api_response(true)
+                    .local_error('401',
+                                 'Unauthorized',
+                                 APIException)
+                    .local_error('403',
+                                 'Forbidden',
+                                 APIException))
+        .execute
+    end
+
+    # This endpoint doesn't consume Apollo credits. Learn more about [API
+    # pricing and credits](https://docs.apollo.io/docs/api-pricing).
+    # Use the Update Call Records endpoint to update your team's call records in
+    # Apollo.<br><br>This endpoint requires a master API key. If you call the
+    # endpoint without a master key, you receive a `403` response. Check out <a
+    # href="https://docs.apollo.io/docs/create-api-key">Create an API Key</a> to
+    # learn how to create a master key.
+    # @param [String] id Required parameter: The Apollo ID for the call record
+    # that you want to update. <br><br>To find call record IDs, call the <a
+    # href="https://docs.apollo.io/reference/search-for-calls#/"
+    # target="_blank">Search for Calls endpoint</a> and identify the `id` value
+    # for the call record. <br><br>Example: `6859b0dd828b270021e69648`
+    # @param [TrueClass | FalseClass] logged Optional parameter: Set to `true`
+    # if you want to create an individual record for the phone call in Apollo.
+    # @param [Array[String]] user_id Optional parameter: Designate the caller in
+    # your team's Apollo account. <br><br>Use the <a
+    # href="https://docs.apollo.io/reference/get-a-list-of-users"
+    # target="_blank">Get a List of Users endpoint</a> to retrieve IDs for all
+    # of the users within your Apollo account. <br><br>Example:
+    # `67e33d527de088000daa60c4`
+    # @param [String] contact_id Optional parameter: Designate the contact that
+    # was called. <br><br>Use the <a
+    # href="https://docs.apollo.io/reference/search-for-contacts#/"
+    # target="_blank">Search for Contacts endpoint</a> to retrieve IDs for all
+    # of the contacts within your Apollo account. <br><br>Example:
+    # `66e34b81740c50074e3d1bd4`
+    # @param [String] account_id Optional parameter: Associate the call with an
+    # account. <br><br>Use the <a
+    # href="https://docs.apollo.io/reference/search-for-accounts#/"
+    # target="_blank">Search for Accounts endpoint</a> to retrieve IDs for all
+    # of the accounts within your Apollo account. <br><br>Example:
+    # `66e9abf95ac32901b20d1a0d`
+    # @param [String] to_number Optional parameter: The phone number that you
+    # dialed. <br><br>Example: `5555550164`
+    # @param [String] from_number Optional parameter: The phone number that
+    # dialed you. <br><br>Example: `5555550164`
+    # @param [String] status Optional parameter: The status of the phone call.
+    # Possible values include: <ul> <li>`queued`</li> <li>`ringing`</li>
+    # <li>`in-progress`</li> <li>`completed`</li> <li>`no_answer`</li>
+    # <li>`failed`</li> <li>`busy`</li></ul>
+    # @param [DateTime] start_time Optional parameter: The time when the call
+    # started. <br><br>Your entry should adhere to the ISO 8601 date-time
+    # format. Apollo uses Greenwich Mean Time (GMT) by default. If you do not
+    # account for time zone differences, you could add a start time that falls
+    # on a different day than you intended. <br><br>The value you enter can
+    # either adhere to GMT, or you can adjust the time manually by specifiying
+    # in hours and minutes how much you want to offset GMT. <br><br>Example:
+    # `2025-02-15T08:10:30Z`; `2025-03-25T10:15:30+05:00Z`
+    # @param [DateTime] end_time Optional parameter: The time when the call
+    # ended. <br><br>Your entry should adhere to the ISO 8601 date-time format.
+    # Apollo uses Greenwich Mean Time (GMT) by default. If you do not account
+    # for time zone differences, you could add a end time that falls on a
+    # different day than you intended. <br><br>The value you enter can either
+    # adhere to GMT, or you can adjust the time manually by specifiying in hours
+    # and minutes how much you want to offset GMT. <br><br>Example:
+    # `2025-05-15T08:10:30Z`; `2025-05-25T10:15:30+05:00Z`
+    # @param [Integer] duration Optional parameter: The duration of the call in
+    # seconds. Do not enter minutes. <br><br>Examples: `120`; `205`
+    # @param [String] phone_call_purpose_id Optional parameter: Assign a call
+    # purpose to the record. <br><br>Call purposes are unique to your team's
+    # Apollo account. When you use the <b>Purpose</b> search filter for calls in
+    # the Apollo product, you can find the corresponding call purpose ID in the
+    # URL. <br><br>Examples: `6095a710bd01d100a506d4cd`
+    # @param [String] phone_call_outcome_id Optional parameter: Assign a call
+    # outcome to the record. <br><br>Call outcomes are unique to your team's
+    # Apollo account. When you use the <b>Disposition</b> search filter for
+    # calls in the Apollo product, you can find the corresponding call outcome
+    # ID in the URL. <br><br>Examples: `6095a710bd01d100a506d4c5`
+    # @param [String] note Optional parameter: Add a note to the call record.
+    # <br><br>Example: `This lead is interested in learning more about our new
+    # product line.`
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def put_phone_callsupdate(id,
+                              logged: nil,
+                              user_id: nil,
+                              contact_id: nil,
+                              account_id: nil,
+                              to_number: nil,
+                              from_number: nil,
+                              status: nil,
+                              start_time: nil,
+                              end_time: nil,
+                              duration: nil,
+                              phone_call_purpose_id: nil,
+                              phone_call_outcome_id: nil,
+                              note: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::PUT,
+                                     '/phone_calls/{id}',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(id, key: 'id')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .query_param(new_parameter(logged, key: 'logged'))
+                   .query_param(new_parameter(user_id, key: 'user_id[]'))
+                   .query_param(new_parameter(contact_id, key: 'contact_id'))
+                   .query_param(new_parameter(account_id, key: 'account_id'))
+                   .query_param(new_parameter(to_number, key: 'to_number'))
+                   .query_param(new_parameter(from_number, key: 'from_number'))
+                   .query_param(new_parameter(status, key: 'status'))
+                   .query_param(new_parameter(start_time, key: 'start_time'))
+                   .query_param(new_parameter(end_time, key: 'end_time'))
+                   .query_param(new_parameter(duration, key: 'duration'))
+                   .query_param(new_parameter(phone_call_purpose_id, key: 'phone_call_purpose_id'))
+                   .query_param(new_parameter(phone_call_outcome_id, key: 'phone_call_outcome_id'))
+                   .query_param(new_parameter(note, key: 'note'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Or.new('bearerAuth', 'apiKey')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:dynamic_deserializer))
+                    .is_api_response(true)
+                    .local_error('401',
+                                 'Unauthorized',
+                                 APIException)
+                    .local_error('403',
+                                 'Forbidden',
+                                 APIException))
+        .execute
+    end
+  end
+end