increase 1.342.0 → 1.344.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 44b0c99f9f94e376bbbde161d7b141bfe9a27643400b13c0c0e134a564d2d698
-  data.tar.gz: ca46f0f817f585ef9d37022233dfae92be8fa56e5efc60053aeb9db60b4ddcad
+  metadata.gz: 20afab8858e9ec6236c7f8339614d1275aeaacf2a32b442cf881574b380cde2c
+  data.tar.gz: 7f9a3de472920bf70178dd94f5c598d5492f115d4959453c2c1011f692725ed2
 SHA512:
-  metadata.gz: 9a16128eea85df7d332895cb12ea94f275053d15b6908a6484a189ce26cdeee98b6998d98e3a64002c82dd84702fc3f9db20dad1481977e70f7ce2c82111a1dd
-  data.tar.gz: 9dba6715858bb4263772de1062463d767e54a10c9a39530aec9c1f04bbc816dc708f1aa567a0b1b13a42f9a4305984b671dafdfa9b86833ea004c62146b539cf
+  metadata.gz: 6f6bfaddbe85bec4d9a75716cb7c258e546114abd6984a67ea77ec386febe9fa67ff9620fbb98ffd79776d984fdaaff11af86079316072db26ff30ff38ef381f
+  data.tar.gz: a30a20214302342fd852a2d5f4c04970097b09105395c9f7d83872c85c650efd293bee0ec285d35b4c71bd30dace8d0232971d5162da137719c410491af04f5c

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "increase", "~> 1.342.0"
+gem "increase", "~> 1.344.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/increase/internal/transport/base_client.rb

@@ -12,18 +12,6 @@ module Increase
         # from whatwg fetch spec
         MAX_REDIRECTS = 20
 
-        # rubocop:disable Style/MutableConstant
-        PLATFORM_HEADERS =
-          {
-            "x-stainless-arch" => Increase::Internal::Util.arch,
-            "x-stainless-lang" => "ruby",
-            "x-stainless-os" => Increase::Internal::Util.os,
-            "x-stainless-package-version" => Increase::VERSION,
-            "x-stainless-runtime" => ::RUBY_ENGINE,
-            "x-stainless-runtime-version" => ::RUBY_ENGINE_VERSION
-          }
-        # rubocop:enable Style/MutableConstant
-
         class << self
           # @api private
           #
@@ -198,7 +186,6 @@ module Increase
         )
           @requester = Increase::Internal::Transport::PooledNetRequester.new
           @headers = Increase::Internal::Util.normalized_headers(
-            self.class::PLATFORM_HEADERS,
             {
               "accept" => "application/json",
               "content-type" => "application/json",
@@ -287,14 +274,7 @@ module Increase
             headers[@idempotency_header] = opts.fetch(:idempotency_key) { generate_idempotency_key }
           end
 
-          unless headers.key?("x-stainless-retry-count")
-            headers["x-stainless-retry-count"] = "0"
-          end
-
           timeout = opts.fetch(:timeout, @timeout).to_f.clamp(0..)
-          unless headers.key?("x-stainless-timeout") || timeout.zero?
-            headers["x-stainless-timeout"] = timeout.to_s
-          end
 
           headers.reject! { |_, v| v.to_s.empty? }
 
@@ -369,18 +349,12 @@ module Increase
         #
         # @param retry_count [Integer]
         #
-        # @param send_retry_header [Boolean]
-        #
         # @raise [Increase::Errors::APIError]
         # @return [Array(Integer, Net::HTTPResponse, Enumerable<String>)]
-        def send_request(request, redirect_count:, retry_count:, send_retry_header:)
-          url, headers, max_retries, timeout = request.fetch_values(:url, :headers, :max_retries, :timeout)
+        def send_request(request, redirect_count:, retry_count:)
+          url, max_retries, timeout = request.fetch_values(:url, :max_retries, :timeout)
           input = {**request.except(:timeout), deadline: Increase::Internal::Util.monotonic_secs + timeout}
 
-          if send_retry_header
-            headers["x-stainless-retry-count"] = retry_count.to_s
-          end
-
           begin
             status, response, stream = @requester.execute(input)
           rescue Increase::Errors::APIConnectionError => e
@@ -403,8 +377,7 @@ module Increase
             send_request(
               request,
               redirect_count: redirect_count + 1,
-              retry_count: retry_count,
-              send_retry_header: send_retry_header
+              retry_count: retry_count
             )
           in Increase::Errors::APIConnectionError if retry_count >= max_retries
             raise status
@@ -432,8 +405,7 @@ module Increase
             send_request(
               request,
               redirect_count: redirect_count,
-              retry_count: retry_count + 1,
-              send_retry_header: send_retry_header
+              retry_count: retry_count + 1
             )
           end
         end
@@ -486,13 +458,10 @@ module Increase
           request = build_request(req.except(:options), opts)
           url = request.fetch(:url)
 
-          # Don't send the current retry count in the headers if the caller modified the header defaults.
-          send_retry_header = request.fetch(:headers)["x-stainless-retry-count"] == "0"
           status, response, stream = send_request(
             request,
             redirect_count: 0,
-            retry_count: 0,
-            send_retry_header: send_retry_header
+            retry_count: 0
           )
 
           headers = Increase::Internal::Util.normalized_headers(response.each_header.to_h)

data/lib/increase/models/beneficial_owner_create_params.rb

@@ -115,19 +115,18 @@ module Increase
           #   @return [String]
           required :city, String
 
+          # @!attribute country
+          #   The two-letter ISO 3166-1 alpha-2 code for the country of the address.
+          #
+          #   @return [String]
+          required :country, String
+
           # @!attribute line1
           #   The first line of the address. This is usually the street number and street.
           #
           #   @return [String]
           required :line1, String
 
-          # @!attribute country
-          #   The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-          #   to `US`.
-          #
-          #   @return [String, nil]
-          optional :country, String
-
           # @!attribute line2
           #   The second line of the address. This might be the floor or room number.
           #
@@ -147,17 +146,15 @@ module Increase
           #   @return [String, nil]
           optional :zip, String
 
-          # @!method initialize(city:, line1:, country: nil, line2: nil, state: nil, zip: nil)
+          # @!method initialize(city:, country:, line1:, line2: nil, state: nil, zip: nil)
           #   The individual's physical address. Mail receiving locations like PO Boxes and
           #   PMB's are disallowed.
           #
           #   @param city [String] The city, district, town, or village of the address.
           #
-          #   @param line1 [String] The first line of the address. This is usually the street number and street.
+          #   @param country [String] The two-letter ISO 3166-1 alpha-2 code for the country of the address.
           #
-          #   @param country [String]
-          #     The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-          #     to `US`.
+          #   @param line1 [String] The first line of the address. This is usually the street number and street.
           #
           #   @param line2 [String] The second line of the address. This might be the floor or room number.
           #

data/lib/increase/models/beneficial_owner_update_params.rb

@@ -84,19 +84,18 @@ module Increase
         #   @return [String]
         required :city, String
 
+        # @!attribute country
+        #   The two-letter ISO 3166-1 alpha-2 code for the country of the address.
+        #
+        #   @return [String]
+        required :country, String
+
         # @!attribute line1
         #   The first line of the address. This is usually the street number and street.
         #
         #   @return [String]
         required :line1, String
 
-        # @!attribute country
-        #   The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-        #   to `US`.
-        #
-        #   @return [String, nil]
-        optional :country, String
-
         # @!attribute line2
         #   The second line of the address. This might be the floor or room number.
         #
@@ -116,17 +115,15 @@ module Increase
         #   @return [String, nil]
         optional :zip, String
 
-        # @!method initialize(city:, line1:, country: nil, line2: nil, state: nil, zip: nil)
+        # @!method initialize(city:, country:, line1:, line2: nil, state: nil, zip: nil)
         #   The individual's physical address. Mail receiving locations like PO Boxes and
         #   PMB's are disallowed.
         #
         #   @param city [String] The city, district, town, or village of the address.
         #
-        #   @param line1 [String] The first line of the address. This is usually the street number and street.
+        #   @param country [String] The two-letter ISO 3166-1 alpha-2 code for the country of the address.
         #
-        #   @param country [String]
-        #     The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-        #     to `US`.
+        #   @param line1 [String] The first line of the address. This is usually the street number and street.
         #
         #   @param line2 [String] The second line of the address. This might be the floor or room number.
         #

data/lib/increase/models/entity_create_params.rb

@@ -281,19 +281,18 @@ module Increase
           #   @return [String]
           required :city, String
 
+          # @!attribute country
+          #   The two-letter ISO 3166-1 alpha-2 code for the country of the address.
+          #
+          #   @return [String]
+          required :country, String
+
           # @!attribute line1
           #   The first line of the address. This is usually the street number and street.
           #
           #   @return [String]
           required :line1, String
 
-          # @!attribute country
-          #   The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-          #   to `US`.
-          #
-          #   @return [String, nil]
-          optional :country, String
-
           # @!attribute line2
           #   The second line of the address. This might be the floor or room number.
           #
@@ -313,17 +312,15 @@ module Increase
           #   @return [String, nil]
           optional :zip, String
 
-          # @!method initialize(city:, line1:, country: nil, line2: nil, state: nil, zip: nil)
+          # @!method initialize(city:, country:, line1:, line2: nil, state: nil, zip: nil)
           #   The entity's physical address. Mail receiving locations like PO Boxes and PMB's
           #   are disallowed.
           #
           #   @param city [String] The city, district, town, or village of the address.
           #
-          #   @param line1 [String] The first line of the address. This is usually the street number and street.
+          #   @param country [String] The two-letter ISO 3166-1 alpha-2 code for the country of the address.
           #
-          #   @param country [String]
-          #     The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-          #     to `US`.
+          #   @param line1 [String] The first line of the address. This is usually the street number and street.
           #
           #   @param line2 [String] The second line of the address. This might be the floor or room number.
           #
@@ -432,19 +429,18 @@ module Increase
               #   @return [String]
               required :city, String
 
+              # @!attribute country
+              #   The two-letter ISO 3166-1 alpha-2 code for the country of the address.
+              #
+              #   @return [String]
+              required :country, String
+
               # @!attribute line1
               #   The first line of the address. This is usually the street number and street.
               #
               #   @return [String]
               required :line1, String
 
-              # @!attribute country
-              #   The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-              #   to `US`.
-              #
-              #   @return [String, nil]
-              optional :country, String
-
               # @!attribute line2
               #   The second line of the address. This might be the floor or room number.
               #
@@ -464,17 +460,15 @@ module Increase
               #   @return [String, nil]
               optional :zip, String
 
-              # @!method initialize(city:, line1:, country: nil, line2: nil, state: nil, zip: nil)
+              # @!method initialize(city:, country:, line1:, line2: nil, state: nil, zip: nil)
               #   The individual's physical address. Mail receiving locations like PO Boxes and
               #   PMB's are disallowed.
               #
               #   @param city [String] The city, district, town, or village of the address.
               #
-              #   @param line1 [String] The first line of the address. This is usually the street number and street.
+              #   @param country [String] The two-letter ISO 3166-1 alpha-2 code for the country of the address.
               #
-              #   @param country [String]
-              #     The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-              #     to `US`.
+              #   @param line1 [String] The first line of the address. This is usually the street number and street.
               #
               #   @param line2 [String] The second line of the address. This might be the floor or room number.
               #
@@ -1024,19 +1018,18 @@ module Increase
             #   @return [String]
             required :city, String
 
+            # @!attribute country
+            #   The two-letter ISO 3166-1 alpha-2 code for the country of the address.
+            #
+            #   @return [String]
+            required :country, String
+
             # @!attribute line1
             #   The first line of the address. This is usually the street number and street.
             #
             #   @return [String]
             required :line1, String
 
-            # @!attribute country
-            #   The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-            #   to `US`.
-            #
-            #   @return [String, nil]
-            optional :country, String
-
             # @!attribute line2
             #   The second line of the address. This might be the floor or room number.
             #
@@ -1056,17 +1049,15 @@ module Increase
             #   @return [String, nil]
             optional :zip, String
 
-            # @!method initialize(city:, line1:, country: nil, line2: nil, state: nil, zip: nil)
+            # @!method initialize(city:, country:, line1:, line2: nil, state: nil, zip: nil)
             #   The individual's physical address. Mail receiving locations like PO Boxes and
             #   PMB's are disallowed.
             #
             #   @param city [String] The city, district, town, or village of the address.
             #
-            #   @param line1 [String] The first line of the address. This is usually the street number and street.
+            #   @param country [String] The two-letter ISO 3166-1 alpha-2 code for the country of the address.
             #
-            #   @param country [String]
-            #     The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-            #     to `US`.
+            #   @param line1 [String] The first line of the address. This is usually the street number and street.
             #
             #   @param line2 [String] The second line of the address. This might be the floor or room number.
             #
@@ -1364,19 +1355,18 @@ module Increase
           #   @return [String]
           required :city, String
 
+          # @!attribute country
+          #   The two-letter ISO 3166-1 alpha-2 code for the country of the address.
+          #
+          #   @return [String]
+          required :country, String
+
           # @!attribute line1
           #   The first line of the address. This is usually the street number and street.
           #
           #   @return [String]
           required :line1, String
 
-          # @!attribute country
-          #   The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-          #   to `US`.
-          #
-          #   @return [String, nil]
-          optional :country, String
-
           # @!attribute line2
           #   The second line of the address. This might be the floor or room number.
           #
@@ -1396,17 +1386,15 @@ module Increase
           #   @return [String, nil]
           optional :zip, String
 
-          # @!method initialize(city:, line1:, country: nil, line2: nil, state: nil, zip: nil)
+          # @!method initialize(city:, country:, line1:, line2: nil, state: nil, zip: nil)
           #   The individual's physical address. Mail receiving locations like PO Boxes and
           #   PMB's are disallowed.
           #
           #   @param city [String] The city, district, town, or village of the address.
           #
-          #   @param line1 [String] The first line of the address. This is usually the street number and street.
+          #   @param country [String] The two-letter ISO 3166-1 alpha-2 code for the country of the address.
           #
-          #   @param country [String]
-          #     The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-          #     to `US`.
+          #   @param line1 [String] The first line of the address. This is usually the street number and street.
           #
           #   @param line2 [String] The second line of the address. This might be the floor or room number.
           #
@@ -2022,19 +2010,18 @@ module Increase
               #   @return [String]
               required :city, String
 
+              # @!attribute country
+              #   The two-letter ISO 3166-1 alpha-2 code for the country of the address.
+              #
+              #   @return [String]
+              required :country, String
+
               # @!attribute line1
               #   The first line of the address. This is usually the street number and street.
               #
               #   @return [String]
               required :line1, String
 
-              # @!attribute country
-              #   The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-              #   to `US`.
-              #
-              #   @return [String, nil]
-              optional :country, String
-
               # @!attribute line2
               #   The second line of the address. This might be the floor or room number.
               #
@@ -2054,17 +2041,15 @@ module Increase
               #   @return [String, nil]
               optional :zip, String
 
-              # @!method initialize(city:, line1:, country: nil, line2: nil, state: nil, zip: nil)
+              # @!method initialize(city:, country:, line1:, line2: nil, state: nil, zip: nil)
               #   The individual's physical address. Mail receiving locations like PO Boxes and
               #   PMB's are disallowed.
               #
               #   @param city [String] The city, district, town, or village of the address.
               #
-              #   @param line1 [String] The first line of the address. This is usually the street number and street.
+              #   @param country [String] The two-letter ISO 3166-1 alpha-2 code for the country of the address.
               #
-              #   @param country [String]
-              #     The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-              #     to `US`.
+              #   @param line1 [String] The first line of the address. This is usually the street number and street.
               #
               #   @param line2 [String] The second line of the address. This might be the floor or room number.
               #
@@ -2363,19 +2348,18 @@ module Increase
             #   @return [String]
             required :city, String
 
+            # @!attribute country
+            #   The two-letter ISO 3166-1 alpha-2 code for the country of the address.
+            #
+            #   @return [String]
+            required :country, String
+
             # @!attribute line1
             #   The first line of the address. This is usually the street number and street.
             #
             #   @return [String]
             required :line1, String
 
-            # @!attribute country
-            #   The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-            #   to `US`.
-            #
-            #   @return [String, nil]
-            optional :country, String
-
             # @!attribute line2
             #   The second line of the address. This might be the floor or room number.
             #
@@ -2395,17 +2379,15 @@ module Increase
             #   @return [String, nil]
             optional :zip, String
 
-            # @!method initialize(city:, line1:, country: nil, line2: nil, state: nil, zip: nil)
+            # @!method initialize(city:, country:, line1:, line2: nil, state: nil, zip: nil)
             #   The individual's physical address. Mail receiving locations like PO Boxes and
             #   PMB's are disallowed.
             #
             #   @param city [String] The city, district, town, or village of the address.
             #
-            #   @param line1 [String] The first line of the address. This is usually the street number and street.
+            #   @param country [String] The two-letter ISO 3166-1 alpha-2 code for the country of the address.
             #
-            #   @param country [String]
-            #     The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-            #     to `US`.
+            #   @param line1 [String] The first line of the address. This is usually the street number and street.
             #
             #   @param line2 [String] The second line of the address. This might be the floor or room number.
             #

data/lib/increase/models/entity_update_params.rb

@@ -202,19 +202,18 @@ module Increase
           #   @return [String]
           required :city, String
 
+          # @!attribute country
+          #   The two-letter ISO 3166-1 alpha-2 code for the country of the address.
+          #
+          #   @return [String]
+          required :country, String
+
           # @!attribute line1
           #   The first line of the address. This is usually the street number and street.
           #
           #   @return [String]
           required :line1, String
 
-          # @!attribute country
-          #   The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-          #   to `US`.
-          #
-          #   @return [String, nil]
-          optional :country, String
-
           # @!attribute line2
           #   The second line of the address. This might be the floor or room number.
           #
@@ -234,17 +233,15 @@ module Increase
           #   @return [String, nil]
           optional :zip, String
 
-          # @!method initialize(city:, line1:, country: nil, line2: nil, state: nil, zip: nil)
+          # @!method initialize(city:, country:, line1:, line2: nil, state: nil, zip: nil)
           #   The entity's physical address. Mail receiving locations like PO Boxes and PMB's
           #   are disallowed.
           #
           #   @param city [String] The city, district, town, or village of the address.
           #
-          #   @param line1 [String] The first line of the address. This is usually the street number and street.
+          #   @param country [String] The two-letter ISO 3166-1 alpha-2 code for the country of the address.
           #
-          #   @param country [String]
-          #     The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-          #     to `US`.
+          #   @param line1 [String] The first line of the address. This is usually the street number and street.
           #
           #   @param line2 [String] The second line of the address. This might be the floor or room number.
           #
@@ -430,19 +427,18 @@ module Increase
           #   @return [String]
           required :city, String
 
+          # @!attribute country
+          #   The two-letter ISO 3166-1 alpha-2 code for the country of the address.
+          #
+          #   @return [String]
+          required :country, String
+
           # @!attribute line1
           #   The first line of the address. This is usually the street number and street.
           #
           #   @return [String]
           required :line1, String
 
-          # @!attribute country
-          #   The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-          #   to `US`.
-          #
-          #   @return [String, nil]
-          optional :country, String
-
           # @!attribute line2
           #   The second line of the address. This might be the floor or room number.
           #
@@ -462,17 +458,15 @@ module Increase
           #   @return [String, nil]
           optional :zip, String
 
-          # @!method initialize(city:, line1:, country: nil, line2: nil, state: nil, zip: nil)
+          # @!method initialize(city:, country:, line1:, line2: nil, state: nil, zip: nil)
           #   The entity's physical address. Mail receiving locations like PO Boxes and PMB's
           #   are disallowed.
           #
           #   @param city [String] The city, district, town, or village of the address.
           #
-          #   @param line1 [String] The first line of the address. This is usually the street number and street.
+          #   @param country [String] The two-letter ISO 3166-1 alpha-2 code for the country of the address.
           #
-          #   @param country [String]
-          #     The two-letter ISO 3166-1 alpha-2 code for the country of the address. Defaults
-          #     to `US`.
+          #   @param line1 [String] The first line of the address. This is usually the street number and street.
           #
           #   @param line2 [String] The second line of the address. This might be the floor or room number.
           #

data/lib/increase/models/event.rb

@@ -355,6 +355,12 @@ module Increase
         # Occurs whenever a Physical Check is updated.
         PHYSICAL_CHECK_UPDATED = :"physical_check.updated"
 
+        # Occurs whenever a Physical Check Book is created.
+        PHYSICAL_CHECK_BOOK_CREATED = :"physical_check_book.created"
+
+        # Occurs whenever a Physical Check Book is updated.
+        PHYSICAL_CHECK_BOOK_UPDATED = :"physical_check_book.updated"
+
         # Occurs whenever a Program is created.
         PROGRAM_CREATED = :"program.created"
 

data/lib/increase/models/event_list_params.rb

@@ -363,6 +363,12 @@ module Increase
           # Occurs whenever a Physical Check is updated.
           PHYSICAL_CHECK_UPDATED = :"physical_check.updated"
 
+          # Occurs whenever a Physical Check Book is created.
+          PHYSICAL_CHECK_BOOK_CREATED = :"physical_check_book.created"
+
+          # Occurs whenever a Physical Check Book is updated.
+          PHYSICAL_CHECK_BOOK_UPDATED = :"physical_check_book.updated"
+
           # Occurs whenever a Program is created.
           PROGRAM_CREATED = :"program.created"
 

data/lib/increase/models/event_subscription.rb

@@ -396,6 +396,12 @@ module Increase
           # Occurs whenever a Physical Check is updated.
           PHYSICAL_CHECK_UPDATED = :"physical_check.updated"
 
+          # Occurs whenever a Physical Check Book is created.
+          PHYSICAL_CHECK_BOOK_CREATED = :"physical_check_book.created"
+
+          # Occurs whenever a Physical Check Book is updated.
+          PHYSICAL_CHECK_BOOK_UPDATED = :"physical_check_book.updated"
+
           # Occurs whenever a Program is created.
           PROGRAM_CREATED = :"program.created"
 

data/lib/increase/models/event_subscription_create_params.rb

@@ -365,6 +365,12 @@ module Increase
           # Occurs whenever a Physical Check is updated.
           PHYSICAL_CHECK_UPDATED = :"physical_check.updated"
 
+          # Occurs whenever a Physical Check Book is created.
+          PHYSICAL_CHECK_BOOK_CREATED = :"physical_check_book.created"
+
+          # Occurs whenever a Physical Check Book is updated.
+          PHYSICAL_CHECK_BOOK_UPDATED = :"physical_check_book.updated"
+
           # Occurs whenever a Program is created.
           PROGRAM_CREATED = :"program.created"
 

data/lib/increase/models/file.rb

@@ -67,7 +67,9 @@ module Increase
       #   Files are objects that represent a file hosted on Increase's servers. The file
       #   may have been uploaded by you (for example, when uploading a check image) or it
       #   may have been created by Increase (for example, an autogenerated statement PDF).
-      #   If you need to download a File, create a File Link.
+      #   If you need to download a File, use the `/files/{file_id}/contents` endpoint. If
+      #   you need to share a File with someone who doesn't have access to your API key,
+      #   create a File Link.
       #
       #   @param id [String] The File's identifier.
       #