gohighlevel 0.0.1

data/lib/high_level/models/users/role_schema.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/users.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module Users
+      RoleSchema = Data.define(:type, :role, :location_ids, :restrict_sub_account)
+    end
+  end
+end

data/lib/high_level/models/users/search_user_successful_response_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/users.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module Users
+      SearchUserSuccessfulResponseDto = Data.define(:users, :count)
+    end
+  end
+end

data/lib/high_level/models/users/update_user_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/users.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module Users
+      UpdateUserDto = Data.define(:first_name, :last_name, :email, :password, :phone, :type, :role, :company_id, :location_ids, :permissions, :scopes, :scopes_assigned_to_only, :profile_photo, :twilio_phone, :platform_language)
+    end
+  end
+end

data/lib/high_level/models/users/user_schema.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/users.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module Users
+      UserSchema = Data.define(:id, :name, :first_name, :last_name, :email, :phone, :extension, :permissions, :scopes, :roles, :deleted, :lc_phone, :platform_language)
+    end
+  end
+end

data/lib/high_level/models/users/user_successful_response_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/users.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module Users
+      UserSuccessfulResponseDto = Data.define(:id, :name, :first_name, :last_name, :email, :phone, :extension, :permissions, :scopes, :roles, :lc_phone, :platform_language)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/agent_action_response_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      AgentActionResponseDTO = Data.define(:id, :action_type, :name, :action_parameters)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/agent_creation_request_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      AgentCreationRequestDTO = Data.define(:location_id, :agent_name, :business_name, :welcome_message, :agent_prompt, :voice_id, :language, :patience_level, :max_call_duration, :send_user_idle_reminders, :reminder_after_idle_time_seconds, :inbound_number, :number_pool_id, :call_end_workflow_ids, :send_post_call_notification_to, :agent_working_hours, :timezone, :is_agent_as_backup_disabled, :translation)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/agent_working_hours_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      AgentWorkingHoursDTO = Data.define(:day_of_the_week, :intervals)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/appointment_booking_action_parameters.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      AppointmentBookingActionParameters = Data.define(:calendar_id, :days_of_offering_dates, :slots_per_day, :hours_between_slots)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/call_action_schema.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      CallActionSchema = Data.define(:action_id, :action_type, :action_name, :action_parameters, :executed_at, :trigger_received_at)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/call_log_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      CallLogDTO = Data.define(:id, :contact_id, :agent_id, :is_agent_deleted, :from_number, :created_at, :duration, :trial_call, :executed_call_actions, :summary, :transcript, :translation, :extracted_data, :message_id)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/call_logs_response_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      CallLogsResponseDTO = Data.define(:total, :page, :page_size, :call_logs)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/call_transfer_action_parameters.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      CallTransferActionParameters = Data.define(:trigger_prompt, :transfer_to_type, :transfer_to_value, :trigger_message, :hear_whisper_message)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/create_action_response_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      CreateActionResponseDTO = Data.define(:id, :action_type, :name, :action_parameters)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/create_agent_response_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      CreateAgentResponseDTO = Data.define(:id, :location_id, :agent_name, :business_name, :welcome_message, :agent_prompt, :voice_id, :language, :patience_level, :max_call_duration, :send_user_idle_reminders, :reminder_after_idle_time_seconds, :inbound_number, :number_pool_id, :call_end_workflow_ids, :send_post_call_notification_to, :agent_working_hours, :timezone, :is_agent_as_backup_disabled, :translation)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/create_single_action_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      CreateSingleActionDTO = Data.define(:agent_id, :location_id, :action_type, :name, :action_parameters)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/custom_action_api_details_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      CustomActionApiDetailsDTO = Data.define(:url, :method, :authentication_required, :authentication_value, :headers, :parameters)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/custom_action_header_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      CustomActionHeaderDTO = Data.define(:key, :value)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/custom_action_parameter_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      CustomActionParameterDTO = Data.define(:name, :description, :type, :example)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/custom_action_parameters.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      CustomActionParameters = Data.define(:trigger_prompt, :trigger_message, :api_details, :selected_paths)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/data_extraction_action_parameters.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      DataExtractionActionParameters = Data.define(:contact_field_id, :description, :examples, :overwrite_existing_value)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/extracted_data_schema.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      ExtractedDataSchema = Data.define
+    end
+  end
+end

data/lib/high_level/models/voice_ai/get_action_response_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      GetActionResponseDTO = Data.define(:id, :action_type, :name, :action_parameters)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/get_agent_response_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      GetAgentResponseDTO = Data.define(:id, :location_id, :agent_name, :business_name, :welcome_message, :agent_prompt, :voice_id, :language, :patience_level, :max_call_duration, :send_user_idle_reminders, :reminder_after_idle_time_seconds, :inbound_number, :number_pool_id, :call_end_workflow_ids, :send_post_call_notification_to, :agent_working_hours, :timezone, :is_agent_as_backup_disabled, :translation, :actions)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/get_agents_response_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      GetAgentsResponseDTO = Data.define(:total, :page, :page_size, :agents)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/in_call_data_extraction_action_parameters.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      InCallDataExtractionActionParameters = Data.define(:contact_field_id, :description, :examples, :overwrite_existing_value)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/interval_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      IntervalDTO = Data.define(:start_hour, :end_hour, :start_minute, :end_minute)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/knowledge_base_parameters.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      KnowledgeBaseParameters = Data.define(:trigger_prompt, :knowledge_base_id)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/patch_agent_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      PatchAgentDTO = Data.define(:agent_name, :business_name, :welcome_message, :agent_prompt, :voice_id, :language, :patience_level, :max_call_duration, :send_user_idle_reminders, :reminder_after_idle_time_seconds, :inbound_number, :number_pool_id, :call_end_workflow_ids, :send_post_call_notification_to, :agent_working_hours, :timezone, :is_agent_as_backup_disabled, :translation)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/patch_agent_response_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      PatchAgentResponseDTO = Data.define(:id, :location_id, :agent_name, :business_name, :welcome_message, :agent_prompt, :voice_id, :language, :patience_level, :max_call_duration, :send_user_idle_reminders, :reminder_after_idle_time_seconds, :inbound_number, :number_pool_id, :call_end_workflow_ids, :send_post_call_notification_to, :agent_working_hours, :timezone, :is_agent_as_backup_disabled, :translation)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/send_post_call_notification_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      SendPostCallNotificationDTO = Data.define(:admins, :all_users, :contact_assigned_user, :specific_users, :custom_emails)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/send_post_call_notification_schema.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      SendPostCallNotificationSchema = Data.define(:admins, :all_users, :contact_assigned_user, :specific_users, :custom_emails)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/sms_parameters.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      SMSParameters = Data.define(:trigger_prompt, :trigger_message, :message_body)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/translation_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      TranslationDTO = Data.define(:enabled, :language)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/translation_schema.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      TranslationSchema = Data.define(:enabled, :language)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/update_action_response_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      UpdateActionResponseDTO = Data.define(:id, :action_type, :name, :action_parameters)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/update_single_action_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      UpdateSingleActionDTO = Data.define(:agent_id, :location_id, :action_type, :name, :action_parameters)
+    end
+  end
+end

data/lib/high_level/models/voice_ai/workflow_trigger_parameters.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/voice-ai.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module VoiceAi
+      WorkflowTriggerParameters = Data.define(:trigger_prompt, :trigger_message, :workflow_id)
+    end
+  end
+end

data/lib/high_level/models/workflows/get_workflow_successful_response_dto.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/workflows.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module Workflows
+      GetWorkflowSuccessfulResponseDto = Data.define(:workflows)
+    end
+  end
+end

data/lib/high_level/models/workflows/workflow_schema.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# GENERATED FROM vendor/openapi/apps/workflows.json @ 192cd68b065a7423c543d82721eb8644cdc883c7
+# DO NOT EDIT — regenerate via bin/generate.
+
+module HighLevel
+  module Models
+    module Workflows
+      WorkflowSchema = Data.define(:id, :name, :status, :version, :created_at, :updated_at, :location_id)
+    end
+  end
+end

data/lib/high_level/oauth.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module HighLevel
+  # OAuth 2.0 client for the HighLevel API.
+  #
+  # Source of truth: https://marketplace.gohighlevel.com/docs/ghl/oauth/
+  #
+  # All HTTP methods POST application/x-www-form-urlencoded bodies; this
+  # class owns its own Faraday connection rather than reusing the main
+  # client's (which is JSON-encoded).
+  class Oauth
+    # Base URL for the marketplace authorization page.
+    MARKETPLACE_URL = "https://marketplace.gohighlevel.com"
+    # The accepted +user_type+ values for the token endpoints.
+    USER_TYPES = %w[Location Company].freeze
+
+    def initialize(config:)
+      @config = config
+    end
+
+    # Build the URL the end user is redirected to in order to grant the app
+    # access. Pure URL construction; no HTTP.
+    def authorization_url(scope:, redirect_uri: nil)
+      params = URI.encode_www_form(
+        client_id: require_value!(:client_id),
+        redirect_uri: redirect_uri || require_value!(:redirect_uri),
+        scope: scope,
+        response_type: "code"
+      )
+      "#{MARKETPLACE_URL}/oauth/chooselocation?#{params}"
+    end
+
+    # Exchange an authorization code for an access + refresh token pair.
+    def exchange_code(code:, user_type:, redirect_uri: nil)
+      assert_user_type!(user_type)
+      post_form("/oauth/token", body: {
+        grant_type: "authorization_code",
+        code: code,
+        client_id: require_value!(:client_id),
+        client_secret: require_value!(:client_secret),
+        user_type: user_type,
+        redirect_uri: redirect_uri || @config.redirect_uri
+      }.compact)
+    end
+
+    # Refresh an access token using its refresh token.
+    def refresh_token(refresh_token:, user_type:)
+      assert_user_type!(user_type)
+      post_form("/oauth/token", body: {
+                  grant_type: "refresh_token",
+                  refresh_token: refresh_token,
+                  client_id: require_value!(:client_id),
+                  client_secret: require_value!(:client_secret),
+                  user_type: user_type
+                })
+    end
+
+    # Derive a location-scoped access token from an agency token.
+    # The agency token is taken from `config.agency_access_token` unless
+    # `authorization_token:` is explicitly supplied (used by the
+    # company-token fallback flow).
+    def get_location_access_token(company_id:, location_id:, authorization_token: nil)
+      bearer = authorization_token || @config.agency_access_token
+      raise ConfigurationError, "agency access token required for get_location_access_token" if bearer.nil?
+
+      post_form(
+        "/oauth/locationToken",
+        body: { companyId: company_id, locationId: location_id },
+        authorization: "Bearer #{bearer}"
+      )
+    end
+
+    private
+
+    def assert_user_type!(user_type)
+      return if USER_TYPES.include?(user_type.to_s)
+
+      raise ArgumentError, "user_type must be one of: #{USER_TYPES.join(", ")}"
+    end
+
+    def require_value!(field)
+      value = @config.public_send(field)
+      raise ConfigurationError, "#{field} is required for this OAuth flow" if value.nil? || value.to_s.empty?
+
+      value
+    end
+
+    def post_form(path, body:, authorization: nil)
+      response = connection.post(path) do |req|
+        req.headers["Content-Type"] = "application/x-www-form-urlencoded"
+        req.headers["Version"] = @config.api_version
+        req.headers["Authorization"] = authorization if authorization
+        req.body = URI.encode_www_form(body)
+      end
+      response.body
+    end
+
+    def connection
+      @connection ||= Faraday.new(url: @config.base_url) do |f|
+        f.use Middleware::ErrorHandler
+        f.response :json, content_type: /\bjson\b/
+        f.adapter Faraday.default_adapter
+      end
+    end
+  end
+end