candidhealth 0.20.1 → 0.24.0.pre.2a6d412

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 94b3a175528969c827073ea49581fdc53a6d31abf6f70494c3b3ad6a1fec2b3a
-  data.tar.gz: 6a8a0a368226fbf299abe0d9275535d42a73a76b3a739498da1db804c622b3ee
+  metadata.gz: 72fe9d3805ad059f12abb2e6ea629db4fec3117ee0438e8dd2e12bd24d4c8c39
+  data.tar.gz: 51cac8dd9657c3fa2eb718e35437171d0797c80894d26c7a75934d546f285947
 SHA512:
-  metadata.gz: 844c6dbfb1e7ab00b512e00108d4222614e18ecb71c666cf9af7fd91bb109b46a0046dfe3ad6f6482b6f19dd2b9607cc20b7fc789bbac1240caa9ccbaa2d2959
-  data.tar.gz: 0cec3cd4b40306370fed79c06621ed937dc39ef7193605a5bba7098ca7b882ab668dc657c4a366e3f55202aaf43cbbb82ed40cdd5517758163aed44212954ed6
+  metadata.gz: 3892c45df0d807acb981ff7eb29b7793c4b270a0290960329d2bd7412aca0b1d21abdb5b38400385d63fe458affddc93f561bab69da091ff3bc96ff4fcfaabb7
+  data.tar.gz: a48add30c0dd8990a3c60053d911a128c352868a6ab251dce88792c58e49471442ec8b7c1623d6428463e6331833a6eb61e36eaa065141d2d041dac68692732f

data/lib/candidhealth/auth/client.rb

@@ -6,22 +6,24 @@ require_relative "v_2/client"
 module CandidApiClient
   module Auth
     class Client
+      # @return [CandidApiClient::Auth::V2::V2Client]
       attr_reader :v_2
 
-      # @param request_client [RequestClient]
-      # @return [Auth::Client]
+      # @param request_client [CandidApiClient::RequestClient]
+      # @return [CandidApiClient::Auth::Client]
       def initialize(request_client:)
-        @v_2 = Auth::V2::V2Client.new(request_client: request_client)
+        @v_2 = CandidApiClient::Auth::V2::V2Client.new(request_client: request_client)
       end
     end
 
     class AsyncClient
+      # @return [CandidApiClient::Auth::V2::AsyncV2Client]
       attr_reader :v_2
 
-      # @param request_client [RequestClient]
-      # @return [Auth::AsyncClient]
+      # @param request_client [CandidApiClient::AsyncRequestClient]
+      # @return [CandidApiClient::Auth::AsyncClient]
       def initialize(request_client:)
-        @v_2 = Auth::V2::AsyncV2Client.new(request_client: request_client)
+        @v_2 = CandidApiClient::Auth::V2::AsyncV2Client.new(request_client: request_client)
       end
     end
   end

data/lib/candidhealth/auth/v_2/client.rb

@@ -8,85 +8,133 @@ module CandidApiClient
   module Auth
     module V2
       class V2Client
+        # @return [CandidApiClient::RequestClient]
         attr_reader :request_client
 
-        # @param request_client [RequestClient]
-        # @return [Auth::V2::V2Client]
+        # @param request_client [CandidApiClient::RequestClient]
+        # @return [CandidApiClient::Auth::V2::V2Client]
         def initialize(request_client:)
-          # @type [RequestClient]
           @request_client = request_client
         end
 
-        # Authenticating with the Candid Health API.
-        #
-        # Candid Health utilizes the [OAuth 2.0 bearer token authentication scheme](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) in our auth flow. You obtain the bearer token for all
-        # subsequent API requests via the `/auth/token` endpoint defined below, which requires you to provide your `client_id` and `client_secret`. Your `client_id` and `client_secret` can be [generated](https://support.joincandidhealth.com/hc/en-us/articles/23065219476244--Generating-Candid-API-Keys) from the "Users & Credentials" tab by your org admin.
-        #
-        # The bearer token should be provided in the `Authorization` header for all subsequent API calls.
-        #
-        # **Warning:**
-        #
-        # The bearer token expires 5 hours after it has been created. After it has expired, the client will receive an "HTTP 401
-        # Unauthorized" error, at which point the client should generate a new token. It is important that tokens be reused between requests; if the client attempts to generate a token too often, it will be rate-limited and will receive an "HTTP 429 Too Many Requests" error.
+        # <Callout intent="info">
+        #  Candid Health SDKs automatically handle authentication workflows after
+        #  configuring them with the `client_id` and
+        #  `client_secret`.
+        #  </Callout>
+        #  Candid Health utilizes the [OAuth 2.0 bearer token authentication
+        #  scheme](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) in our
+        #  auth flow. You obtain the bearer token for all
+        #  subsequent API requests via the `/auth/token` endpoint defined below, which
+        #  requires you to provide your `client_id` and `client_secret`. Your `client_id`
+        #  and `client_secret` can be
+        #  incandidhealth.com/hc/en-us/articles/23065219476244--Generating-Candid-API-Keys)
+        #  from the "Users & Credentials" tab by your org admin.
+        #  The bearer token is a signed [JWT](https://jwt.io/). The public key for the JWT
+        #  can be found [here](https://candidhealth.auth0.com/pem) for any verification
+        #  workflows.
+        #  The bearer token should be provided in the `Authorization` header for all
+        #  subsequent API calls.
+        #  <Callout intent="warning">
+        #  The bearer token expires 5 hours after it has been created. After it has
+        #  expired, the client will receive an "HTTP 401
+        #  Unauthorized" error, at which point the client should generate a new token. It
+        #  is important that tokens be reused between
+        #  requests; if the client attempts to generate a token too often, it will be
+        #  rate-limited and will receive an `HTTP 429 Too Many Requests` error.
+        #  </Callout>
         #
         # @param client_id [String] Your application's Client ID.
         # @param client_secret [String] Your application's Client Secret.
-        # @param request_options [RequestOptions]
-        # @return [Auth::V2::AuthGetTokenResponse]
+        # @param request_options [CandidApiClient::RequestOptions]
+        # @return [CandidApiClient::Auth::V2::Types::AuthGetTokenResponse]
+        # @example
+        #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+        #  api.auth.v_2.get_token(client_id: "YOUR_CLIENT_ID", client_secret: "YOUR_CLIENT_SECRET")
         def get_token(client_id:, client_secret:, request_options: nil)
-          response = @request_client.conn.post("/api/auth/v2/token") do |req|
+          response = @request_client.conn.post do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
-            req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+            req.headers = {
+          **(req.headers || {}),
+          **@request_client.get_headers,
+          **(request_options&.additional_headers || {})
+            }.compact
             req.body = {
               **(request_options&.additional_body_parameters || {}),
               client_id: client_id,
               client_secret: client_secret
             }.compact
+            req.url "#{@request_client.get_url(environment: CandidApi,
+                                               request_options: request_options)}/api/auth/v2/token"
           end
-          Auth::V2::AuthGetTokenResponse.from_json(json_object: response.body)
+          CandidApiClient::Auth::V2::Types::AuthGetTokenResponse.from_json(json_object: response.body)
         end
       end
 
       class AsyncV2Client
+        # @return [CandidApiClient::AsyncRequestClient]
         attr_reader :request_client
 
-        # @param request_client [AsyncRequestClient]
-        # @return [Auth::V2::AsyncV2Client]
+        # @param request_client [CandidApiClient::AsyncRequestClient]
+        # @return [CandidApiClient::Auth::V2::AsyncV2Client]
         def initialize(request_client:)
-          # @type [AsyncRequestClient]
           @request_client = request_client
         end
 
-        # Authenticating with the Candid Health API.
-        #
-        # Candid Health utilizes the [OAuth 2.0 bearer token authentication scheme](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) in our auth flow. You obtain the bearer token for all
-        # subsequent API requests via the `/auth/token` endpoint defined below, which requires you to provide your `client_id` and `client_secret`. Your `client_id` and `client_secret` can be [generated](https://support.joincandidhealth.com/hc/en-us/articles/23065219476244--Generating-Candid-API-Keys) from the "Users & Credentials" tab by your org admin.
-        #
-        # The bearer token should be provided in the `Authorization` header for all subsequent API calls.
-        #
-        # **Warning:**
-        #
-        # The bearer token expires 5 hours after it has been created. After it has expired, the client will receive an "HTTP 401
-        # Unauthorized" error, at which point the client should generate a new token. It is important that tokens be reused between requests; if the client attempts to generate a token too often, it will be rate-limited and will receive an "HTTP 429 Too Many Requests" error.
+        # <Callout intent="info">
+        #  Candid Health SDKs automatically handle authentication workflows after
+        #  configuring them with the `client_id` and
+        #  `client_secret`.
+        #  </Callout>
+        #  Candid Health utilizes the [OAuth 2.0 bearer token authentication
+        #  scheme](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) in our
+        #  auth flow. You obtain the bearer token for all
+        #  subsequent API requests via the `/auth/token` endpoint defined below, which
+        #  requires you to provide your `client_id` and `client_secret`. Your `client_id`
+        #  and `client_secret` can be
+        #  incandidhealth.com/hc/en-us/articles/23065219476244--Generating-Candid-API-Keys)
+        #  from the "Users & Credentials" tab by your org admin.
+        #  The bearer token is a signed [JWT](https://jwt.io/). The public key for the JWT
+        #  can be found [here](https://candidhealth.auth0.com/pem) for any verification
+        #  workflows.
+        #  The bearer token should be provided in the `Authorization` header for all
+        #  subsequent API calls.
+        #  <Callout intent="warning">
+        #  The bearer token expires 5 hours after it has been created. After it has
+        #  expired, the client will receive an "HTTP 401
+        #  Unauthorized" error, at which point the client should generate a new token. It
+        #  is important that tokens be reused between
+        #  requests; if the client attempts to generate a token too often, it will be
+        #  rate-limited and will receive an `HTTP 429 Too Many Requests` error.
+        #  </Callout>
         #
         # @param client_id [String] Your application's Client ID.
         # @param client_secret [String] Your application's Client Secret.
-        # @param request_options [RequestOptions]
-        # @return [Auth::V2::AuthGetTokenResponse]
+        # @param request_options [CandidApiClient::RequestOptions]
+        # @return [CandidApiClient::Auth::V2::Types::AuthGetTokenResponse]
+        # @example
+        #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+        #  api.auth.v_2.get_token(client_id: "YOUR_CLIENT_ID", client_secret: "YOUR_CLIENT_SECRET")
         def get_token(client_id:, client_secret:, request_options: nil)
           Async do
-            response = @request_client.conn.post("/api/auth/v2/token") do |req|
+            response = @request_client.conn.post do |req|
               req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
               req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
-              req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+              req.headers = {
+            **(req.headers || {}),
+            **@request_client.get_headers,
+            **(request_options&.additional_headers || {})
+              }.compact
               req.body = {
                 **(request_options&.additional_body_parameters || {}),
                 client_id: client_id,
                 client_secret: client_secret
               }.compact
+              req.url "#{@request_client.get_url(environment: CandidApi,
+                                                 request_options: request_options)}/api/auth/v2/token"
             end
-            Auth::V2::AuthGetTokenResponse.from_json(json_object: response.body)
+            CandidApiClient::Auth::V2::Types::AuthGetTokenResponse.from_json(json_object: response.body)
           end
         end
       end

data/lib/candidhealth/auth/v_2/types/auth_get_token_response.rb

@@ -1,57 +1,75 @@
 # frozen_string_literal: true
 
+require "ostruct"
 require "json"
 
 module CandidApiClient
   module Auth
     module V2
-      class AuthGetTokenResponse
-        attr_reader :access_token, :expires_in, :token_type, :additional_properties
+      module Types
+        class AuthGetTokenResponse
+          # @return [String]
+          attr_reader :access_token
+          # @return [Integer] Time in seconds.
+          attr_reader :expires_in
+          # @return [String]
+          attr_reader :token_type
+          # @return [OpenStruct] Additional properties unmapped to the current class definition
+          attr_reader :additional_properties
+          # @return [Object]
+          attr_reader :_field_set
+          protected :_field_set
 
-        # @param access_token [String]
-        # @param expires_in [Integer] Time in seconds.
-        # @param token_type [String]
-        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
-        # @return [Auth::V2::AuthGetTokenResponse]
-        def initialize(access_token:, expires_in:, token_type:, additional_properties: nil)
-          # @type [String]
-          @access_token = access_token
-          # @type [Integer] Time in seconds.
-          @expires_in = expires_in
-          # @type [String]
-          @token_type = token_type
-          # @type [OpenStruct] Additional properties unmapped to the current class definition
-          @additional_properties = additional_properties
-        end
+          OMIT = Object.new
 
-        # Deserialize a JSON object to an instance of AuthGetTokenResponse
-        #
-        # @param json_object [JSON]
-        # @return [Auth::V2::AuthGetTokenResponse]
-        def self.from_json(json_object:)
-          struct = JSON.parse(json_object, object_class: OpenStruct)
-          JSON.parse(json_object)
-          access_token = struct.access_token
-          expires_in = struct.expires_in
-          token_type = struct.token_type
-          new(access_token: access_token, expires_in: expires_in, token_type: token_type, additional_properties: struct)
-        end
+          # @param access_token [String]
+          # @param expires_in [Integer] Time in seconds.
+          # @param token_type [String]
+          # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+          # @return [CandidApiClient::Auth::V2::Types::AuthGetTokenResponse]
+          def initialize(access_token:, expires_in:, token_type:, additional_properties: nil)
+            @access_token = access_token
+            @expires_in = expires_in
+            @token_type = token_type
+            @additional_properties = additional_properties
+            @_field_set = { "access_token": access_token, "expires_in": expires_in, "token_type": token_type }
+          end
 
-        # Serialize an instance of AuthGetTokenResponse to a JSON object
-        #
-        # @return [JSON]
-        def to_json(*_args)
-          { "access_token": @access_token, "expires_in": @expires_in, "token_type": @token_type }.to_json
-        end
+          # Deserialize a JSON object to an instance of AuthGetTokenResponse
+          #
+          # @param json_object [String]
+          # @return [CandidApiClient::Auth::V2::Types::AuthGetTokenResponse]
+          def self.from_json(json_object:)
+            struct = JSON.parse(json_object, object_class: OpenStruct)
+            access_token = struct["access_token"]
+            expires_in = struct["expires_in"]
+            token_type = struct["token_type"]
+            new(
+              access_token: access_token,
+              expires_in: expires_in,
+              token_type: token_type,
+              additional_properties: struct
+            )
+          end
+
+          # Serialize an instance of AuthGetTokenResponse to a JSON object
+          #
+          # @return [String]
+          def to_json(*_args)
+            @_field_set&.to_json
+          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:)
-          obj.access_token.is_a?(String) != false || raise("Passed value for field obj.access_token is not the expected type, validation failed.")
-          obj.expires_in.is_a?(Integer) != false || raise("Passed value for field obj.expires_in is not the expected type, validation failed.")
-          obj.token_type.is_a?(String) != false || raise("Passed value for field obj.token_type is not the expected type, validation failed.")
+          # 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:)
+            obj.access_token.is_a?(String) != false || raise("Passed value for field obj.access_token is not the expected type, validation failed.")
+            obj.expires_in.is_a?(Integer) != false || raise("Passed value for field obj.expires_in is not the expected type, validation failed.")
+            obj.token_type.is_a?(String) != false || raise("Passed value for field obj.token_type is not the expected type, validation failed.")
+          end
         end
       end
     end

data/lib/candidhealth/auth/v_2/types/too_many_requests_error_type.rb

@@ -1,47 +1,58 @@
 # frozen_string_literal: true
 
+require "ostruct"
 require "json"
 
 module CandidApiClient
   module Auth
     module V2
-      class TooManyRequestsErrorType
-        attr_reader :message, :additional_properties
+      module Types
+        class TooManyRequestsErrorType
+          # @return [String]
+          attr_reader :message
+          # @return [OpenStruct] Additional properties unmapped to the current class definition
+          attr_reader :additional_properties
+          # @return [Object]
+          attr_reader :_field_set
+          protected :_field_set
 
-        # @param message [String]
-        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
-        # @return [Auth::V2::TooManyRequestsErrorType]
-        def initialize(message:, additional_properties: nil)
-          # @type [String]
-          @message = message
-          # @type [OpenStruct] Additional properties unmapped to the current class definition
-          @additional_properties = additional_properties
-        end
+          OMIT = Object.new
 
-        # Deserialize a JSON object to an instance of TooManyRequestsErrorType
-        #
-        # @param json_object [JSON]
-        # @return [Auth::V2::TooManyRequestsErrorType]
-        def self.from_json(json_object:)
-          struct = JSON.parse(json_object, object_class: OpenStruct)
-          JSON.parse(json_object)
-          message = struct.message
-          new(message: message, additional_properties: struct)
-        end
+          # @param message [String]
+          # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+          # @return [CandidApiClient::Auth::V2::Types::TooManyRequestsErrorType]
+          def initialize(message:, additional_properties: nil)
+            @message = message
+            @additional_properties = additional_properties
+            @_field_set = { "message": message }
+          end
 
-        # Serialize an instance of TooManyRequestsErrorType to a JSON object
-        #
-        # @return [JSON]
-        def to_json(*_args)
-          { "message": @message }.to_json
-        end
+          # Deserialize a JSON object to an instance of TooManyRequestsErrorType
+          #
+          # @param json_object [String]
+          # @return [CandidApiClient::Auth::V2::Types::TooManyRequestsErrorType]
+          def self.from_json(json_object:)
+            struct = JSON.parse(json_object, object_class: OpenStruct)
+            message = struct["message"]
+            new(message: message, additional_properties: struct)
+          end
+
+          # Serialize an instance of TooManyRequestsErrorType to a JSON object
+          #
+          # @return [String]
+          def to_json(*_args)
+            @_field_set&.to_json
+          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:)
-          obj.message.is_a?(String) != false || raise("Passed value for field obj.message is not the expected type, validation failed.")
+          # 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:)
+            obj.message.is_a?(String) != false || raise("Passed value for field obj.message is not the expected type, validation failed.")
+          end
         end
       end
     end

data/lib/candidhealth/billing_notes/client.rb

@@ -6,22 +6,24 @@ require_relative "v_2/client"
 module CandidApiClient
   module BillingNotes
     class Client
+      # @return [CandidApiClient::BillingNotes::V2::V2Client]
       attr_reader :v_2
 
-      # @param request_client [RequestClient]
-      # @return [BillingNotes::Client]
+      # @param request_client [CandidApiClient::RequestClient]
+      # @return [CandidApiClient::BillingNotes::Client]
       def initialize(request_client:)
-        @v_2 = BillingNotes::V2::V2Client.new(request_client: request_client)
+        @v_2 = CandidApiClient::BillingNotes::V2::V2Client.new(request_client: request_client)
       end
     end
 
     class AsyncClient
+      # @return [CandidApiClient::BillingNotes::V2::AsyncV2Client]
       attr_reader :v_2
 
-      # @param request_client [RequestClient]
-      # @return [BillingNotes::AsyncClient]
+      # @param request_client [CandidApiClient::AsyncRequestClient]
+      # @return [CandidApiClient::BillingNotes::AsyncClient]
       def initialize(request_client:)
-        @v_2 = BillingNotes::V2::AsyncV2Client.new(request_client: request_client)
+        @v_2 = CandidApiClient::BillingNotes::V2::AsyncV2Client.new(request_client: request_client)
       end
     end
   end

data/lib/candidhealth/billing_notes/v_2/client.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "../../../requests"
-require_relative "../../commons/types/encounter_id"
+require "ostruct"
 require_relative "types/billing_note"
 require "async"
 
@@ -9,65 +9,87 @@ module CandidApiClient
   module BillingNotes
     module V2
       class V2Client
+        # @return [CandidApiClient::RequestClient]
         attr_reader :request_client
 
-        # @param request_client [RequestClient]
-        # @return [BillingNotes::V2::V2Client]
+        # @param request_client [CandidApiClient::RequestClient]
+        # @return [CandidApiClient::BillingNotes::V2::V2Client]
         def initialize(request_client:)
-          # @type [RequestClient]
           @request_client = request_client
         end
 
         # @param text [String] Empty string not allowed.
         # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
-        # @param encounter_id [Commons::ENCOUNTER_ID]
-        # @param request_options [RequestOptions]
-        # @return [BillingNotes::V2::BillingNote]
-        def create(text:, encounter_id:, additional_properties: nil, request_options: nil)
-          response = @request_client.conn.post("/api/billing_notes/v2") do |req|
+        # @param _field_set [Object]
+        # @param encounter_id [String]
+        # @param request_options [CandidApiClient::RequestOptions]
+        # @return [CandidApiClient::BillingNotes::V2::Types::BillingNote]
+        # @example
+        #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+        #  api.billing_notes.v_2.create(encounter_id: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32")
+        def create(text:, encounter_id:, additional_properties: nil, _field_set: 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["Authorization"] = request_options.token unless request_options&.token.nil?
-            req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+            req.headers = {
+          **(req.headers || {}),
+          **@request_client.get_headers,
+          **(request_options&.additional_headers || {})
+            }.compact
             req.body = {
               **(request_options&.additional_body_parameters || {}),
               text: text,
               additional_properties: additional_properties,
+              _field_set: _field_set,
               encounter_id: encounter_id
             }.compact
+            req.url "#{@request_client.get_url(environment: CandidApi,
+                                               request_options: request_options)}/api/billing_notes/v2"
           end
-          BillingNotes::V2::BillingNote.from_json(json_object: response.body)
+          CandidApiClient::BillingNotes::V2::Types::BillingNote.from_json(json_object: response.body)
         end
       end
 
       class AsyncV2Client
+        # @return [CandidApiClient::AsyncRequestClient]
         attr_reader :request_client
 
-        # @param request_client [AsyncRequestClient]
-        # @return [BillingNotes::V2::AsyncV2Client]
+        # @param request_client [CandidApiClient::AsyncRequestClient]
+        # @return [CandidApiClient::BillingNotes::V2::AsyncV2Client]
         def initialize(request_client:)
-          # @type [AsyncRequestClient]
           @request_client = request_client
         end
 
         # @param text [String] Empty string not allowed.
         # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
-        # @param encounter_id [Commons::ENCOUNTER_ID]
-        # @param request_options [RequestOptions]
-        # @return [BillingNotes::V2::BillingNote]
-        def create(text:, encounter_id:, additional_properties: nil, request_options: nil)
+        # @param _field_set [Object]
+        # @param encounter_id [String]
+        # @param request_options [CandidApiClient::RequestOptions]
+        # @return [CandidApiClient::BillingNotes::V2::Types::BillingNote]
+        # @example
+        #  api = CandidApiClient::Client.new(base_url: "https://api.example.com", environment: CandidApiClient::Environment::PRODUCTION)
+        #  api.billing_notes.v_2.create(encounter_id: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32")
+        def create(text:, encounter_id:, additional_properties: nil, _field_set: nil, request_options: nil)
           Async do
-            response = @request_client.conn.post("/api/billing_notes/v2") do |req|
+            response = @request_client.conn.post do |req|
               req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
               req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
-              req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+              req.headers = {
+            **(req.headers || {}),
+            **@request_client.get_headers,
+            **(request_options&.additional_headers || {})
+              }.compact
               req.body = {
                 **(request_options&.additional_body_parameters || {}),
                 text: text,
                 additional_properties: additional_properties,
+                _field_set: _field_set,
                 encounter_id: encounter_id
               }.compact
+              req.url "#{@request_client.get_url(environment: CandidApi,
+                                                 request_options: request_options)}/api/billing_notes/v2"
             end
-            BillingNotes::V2::BillingNote.from_json(json_object: response.body)
+            CandidApiClient::BillingNotes::V2::Types::BillingNote.from_json(json_object: response.body)
           end
         end
       end