files.com 1.1.812 → 1.1.814

data/doc/Files/ApiClient.html

@@ -108,7 +108,7 @@
     
   
     
-      <strong class="classes">Classes:</strong> <span class='object_link'><a href="ApiClient/RequestLogContext.html" title="Files::ApiClient::RequestLogContext (class)">RequestLogContext</a></span>
+      <strong class="classes">Classes:</strong> <span class='object_link'><a href="ApiClient/RequestLogContext.html" title="Files::ApiClient::RequestLogContext (class)">RequestLogContext</a></span>, <span class='object_link'><a href="ApiClient/TransferSettings.html" title="Files::ApiClient::TransferSettings (class)">TransferSettings</a></span>
     
   
 </p>
@@ -292,6 +292,28 @@
         <li class="public ">
   <span class="summary_signature">
     
+      <a href="#proxy_identity-class_method" title="proxy_identity (class method)">.<strong>proxy_identity</strong>(proxy)  &#x21d2; Object </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>A Files.proxy value, a URL or a Hash of its uri, user and password, as one frozen [URL, user, password], its user and password included, or nil for none.</p></div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
       <a href="#should_retry%3F-class_method" title="should_retry? (class method)">.<strong>should_retry?</strong>(error, num_retries)  &#x21d2; Boolean </a>
     
 
@@ -314,6 +336,28 @@
         <li class="public ">
   <span class="summary_signature">
     
+      <a href="#single_attempt-class_method" title="single_attempt (class method)">.<strong>single_attempt</strong>  &#x21d2; Object </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>Runs the block with each transfer request this thread sends through remote_request sent once: a failure is logged as usual but neither retried nor converted, so Faraday's own error, with any response it got, reaches the caller.</p></div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
       <a href="#sleep_time-class_method" title="sleep_time (class method)">.<strong>sleep_time</strong>(num_retries)  &#x21d2; Object </a>
     
 
@@ -333,6 +377,72 @@
 </li>
 
       
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#transfer_settings-class_method" title="transfer_settings (class method)">.<strong>transfer_settings</strong>  &#x21d2; Object </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>The library-wide settings as they are now: frozen copies of Files.default_headers (a Proc is kept as it is, and still called for each request), Files.language and Files.app_info, the timeouts, Files.region_policy, and Files.region_handler, kept as it is.</p></div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#unchanged_default_conn%3F-class_method" title="unchanged_default_conn? (class method)">.<strong>unchanged_default_conn?</strong>(conn, proxy)  &#x21d2; Boolean </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>Whether conn is a connection build_default_conn made with proxy, as proxy_identity gives it (nil when it was given none, so it follows the proxy environment variables), with nothing about it changed since: the same middleware and adapter (the same objects, so neither another adapter nor one with a configuration block of its own), and the same TLS, request and proxy options, default headers and default parameters.</p></div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#user_agent_with_metadata-class_method" title="user_agent_with_metadata (class method)">.<strong>user_agent_with_metadata</strong>(identity, host_os: , ruby_engine: RUBY_ENGINE, ruby_version: RUBY_VERSION)  &#x21d2; Object </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>The User-Agent the SDK sends with its own API requests: identity, the SDK's name and version and any app info, followed by one comment naming the coarse family of the operating system host_os (RbConfig's) names and the Ruby runtime, with ruby_version for CRuby, such as &quot;Files.com Ruby SDK v1.2.3 (files-sdk-meta/1; os=linux; runtime=ruby/3.4.4)&quot;.</p></div></span>
+  
+</li>
+
+      
     </ul>
     
   
@@ -368,7 +478,29 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#execute_request-instance_method" title="#execute_request (instance method)">#<strong>execute_request</strong>(method, path, base_url: nil, api_key: nil, session_id: nil, workspace_id: nil, region_http_pairs: nil, headers: {}, params: {}, &amp;on_request_context)  &#x21d2; Object </a>
+      <a href="#default_transfer_behavior%3F-instance_method" title="#default_transfer_behavior? (instance method)">#<strong>default_transfer_behavior?</strong>  &#x21d2; Boolean </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>Whether this client sends transfer requests just as the SDK's own default client does: an ApiClient itself, not a subclass or an object with methods of its own, with no logger or log level of its own.</p></div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#execute_request-instance_method" title="#execute_request (instance method)">#<strong>execute_request</strong>(method, path, base_url: nil, api_key: nil, session_id: nil, workspace_id: nil, region_http_pairs: nil, settings: nil, headers: {}, params: {}, &amp;on_request_context)  &#x21d2; Object </a>
     
 
     
@@ -472,7 +604,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>Sends a request to a transfer URL, such as a signed storage URL, through this client's connection, with its middleware, adapter, settings and logging.</p></div></span>
   
 </li>
 
@@ -502,6 +634,28 @@
         <li class="public ">
   <span class="summary_signature">
     
+      <a href="#resolved_workspace_id-instance_method" title="#resolved_workspace_id (instance method)">#<strong>resolved_workspace_id</strong>  &#x21d2; Object </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>The workspace_id option that names, for every later request, the workspace this client's requests name now when their own workspace_id is nil: its own, or Files.workspace_id, and &quot;&quot; for none.</p></div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
       <a href="#stream_download-instance_method" title="#stream_download (instance method)">#<strong>stream_download</strong>(uri, io, range)  &#x21d2; Object </a>
     
 
@@ -728,12 +882,17 @@ your own development servers only (see Files.region_http_pairs=).</p>
 102
 103
 104
-105</pre>
+105
+106
+107
+108
+109</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 78</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_build_default_conn'>build_default_conn</span><span class='lparen'>(</span><span class='label'>force_net_http:</span> <span class='kw'>false</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_proxy'>proxy</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_proxy'><span class='object_link'><a href="../Files.html#proxy-class_method" title="Files.proxy (method)">proxy</a></span></span>
   <span class='id identifier rubyid_conn'>conn</span> <span class='op'>=</span> <span class='const'>Faraday</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_builder'>builder</span><span class='op'>|</span>
     <span class='kw'>if</span> <span class='const'>Gem</span><span class='op'>::</span><span class='const'>Version</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='const'>Faraday</span><span class='op'>::</span><span class='const'>VERSION</span><span class='rparen'>)</span> <span class='op'>&lt;</span> <span class='const'>Gem</span><span class='op'>::</span><span class='const'>Version</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>2.0.0</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span> <span class='op'>&amp;&amp;</span> <span class='kw'>defined?</span><span class='lparen'>(</span><span class='const'>Faraday</span><span class='op'>::</span><span class='const'>Request</span><span class='op'>::</span><span class='const'>Multipart</span><span class='rparen'>)</span>
       <span class='kw'>begin</span>
@@ -756,8 +915,11 @@ your own development servers only (see Files.region_http_pairs=).</p>
     <span class='kw'>end</span>
   <span class='kw'>end</span>
 
-  <span class='id identifier rubyid_conn'>conn</span><span class='period'>.</span><span class='id identifier rubyid_proxy'>proxy</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_proxy'><span class='object_link'><a href="../Files.html#proxy-class_method" title="Files.proxy (method)">proxy</a></span></span> <span class='kw'>if</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_proxy'><span class='object_link'><a href="../Files.html#proxy-class_method" title="Files.proxy (method)">proxy</a></span></span>
+  <span class='id identifier rubyid_conn'>conn</span><span class='period'>.</span><span class='id identifier rubyid_proxy'>proxy</span> <span class='op'>=</span> <span class='id identifier rubyid_proxy'>proxy</span> <span class='kw'>if</span> <span class='id identifier rubyid_proxy'>proxy</span>
   <span class='id identifier rubyid_conn'>conn</span><span class='period'>.</span><span class='id identifier rubyid_ssl'>ssl</span><span class='period'>.</span><span class='id identifier rubyid_verify'>verify</span> <span class='op'>=</span> <span class='kw'>true</span>
+  <span class='comment'># How it was made, and with which proxy, so unchanged_default_conn? can tell whether anything about it has changed
+</span>  <span class='comment'># since.
+</span>  <span class='id identifier rubyid_conn'>conn</span><span class='period'>.</span><span class='id identifier rubyid_instance_variable_set'>instance_variable_set</span><span class='lparen'>(</span><span class='symbol'>:@files_sdk_configuration</span><span class='comma'>,</span> <span class='lbracket'>[</span> <span class='id identifier rubyid_connection_configuration'>connection_configuration</span><span class='lparen'>(</span><span class='id identifier rubyid_conn'>conn</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_proxy_identity'>proxy_identity</span><span class='lparen'>(</span><span class='id identifier rubyid_proxy'>proxy</span><span class='rparen'>)</span> <span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span><span class='rparen'>)</span>
 
   <span class='id identifier rubyid_conn'>conn</span>
 <span class='kw'>end</span></pre>
@@ -894,6 +1056,48 @@ falling back to net_http.</p>
     </td>
   </tr>
 </table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="proxy_identity-class_method">
+  
+    .<strong>proxy_identity</strong>(proxy)  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>A Files.proxy value, a URL or a Hash of its uri, user and password, as one frozen [URL, user, password], its user
+and password included, or nil for none.</p>
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+125
+126
+127
+128</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 125</span>
+
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_proxy_identity'>proxy_identity</span><span class='lparen'>(</span><span class='id identifier rubyid_proxy'>proxy</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_options'>options</span> <span class='op'>=</span> <span class='id identifier rubyid_proxy'>proxy</span> <span class='op'>&amp;&amp;</span> <span class='const'>Faraday</span><span class='op'>::</span><span class='const'>ProxyOptions</span><span class='period'>.</span><span class='id identifier rubyid_from'>from</span><span class='lparen'>(</span><span class='id identifier rubyid_proxy'>proxy</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_options'>options</span><span class='op'>&amp;.</span><span class='id identifier rubyid_uri'>uri</span> <span class='op'>&amp;&amp;</span> <span class='lbracket'>[</span> <span class='id identifier rubyid_options'>options</span><span class='period'>.</span><span class='id identifier rubyid_uri'>uri</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='comma'>,</span> <span class='id identifier rubyid_options'>options</span><span class='period'>.</span><span class='id identifier rubyid_user'>user</span><span class='comma'>,</span> <span class='id identifier rubyid_options'>options</span><span class='period'>.</span><span class='id identifier rubyid_password'>password</span> <span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
     
       <div class="method_details ">
@@ -933,19 +1137,19 @@ falling back to net_http.</p>
       <pre class="lines">
 
 
-107
-108
-109
-110
-111
-112
-113
-114
-115
-116</pre>
+216
+217
+218
+219
+220
+221
+222
+223
+224
+225</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 107</span>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 216</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_should_retry?'>should_retry?</span><span class='lparen'>(</span><span class='id identifier rubyid_error'>error</span><span class='comma'>,</span> <span class='id identifier rubyid_num_retries'>num_retries</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>false</span> <span class='kw'>if</span> <span class='id identifier rubyid_num_retries'>num_retries</span> <span class='op'>&gt;=</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_max_network_retries'><span class='object_link'><a href="../Files.html#max_network_retries-class_method" title="Files.max_network_retries (method)">max_network_retries</a></span></span>
@@ -960,6 +1164,56 @@ falling back to net_http.</p>
     </td>
   </tr>
 </table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="single_attempt-class_method">
+  
+    .<strong>single_attempt</strong>  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Runs the block with each transfer request this thread sends through remote_request sent once: a failure is
+logged as usual but neither retried nor converted, so Faraday's own error, with any response it got, reaches
+the caller. An adaptive transfer sends its content requests through a caller's client this way, since it
+schedules and counts every retry itself.</p>
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+139
+140
+141
+142
+143
+144
+145</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 139</span>
+
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_single_attempt'>single_attempt</span>
+  <span class='id identifier rubyid_previous'>previous</span> <span class='op'>=</span> <span class='const'>Thread</span><span class='period'>.</span><span class='id identifier rubyid_current'>current</span><span class='lbracket'>[</span><span class='symbol'>:files_api_client_single_attempt</span><span class='rbracket'>]</span>
+  <span class='const'>Thread</span><span class='period'>.</span><span class='id identifier rubyid_current'>current</span><span class='lbracket'>[</span><span class='symbol'>:files_api_client_single_attempt</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='kw'>true</span>
+  <span class='kw'>yield</span>
+<span class='kw'>ensure</span>
+  <span class='const'>Thread</span><span class='period'>.</span><span class='id identifier rubyid_current'>current</span><span class='lbracket'>[</span><span class='symbol'>:files_api_client_single_attempt</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_previous'>previous</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
     
       <div class="method_details ">
@@ -977,17 +1231,17 @@ falling back to net_http.</p>
       <pre class="lines">
 
 
-118
-119
-120
-121
-122
-123
-124
-125</pre>
+227
+228
+229
+230
+231
+232
+233
+234</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 118</span>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 227</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_sleep_time'>sleep_time</span><span class='lparen'>(</span><span class='id identifier rubyid_num_retries'>num_retries</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_sleep_seconds'>sleep_seconds</span> <span class='op'>=</span> <span class='lbracket'>[</span>
@@ -1002,36 +1256,109 @@ falling back to net_http.</p>
 </table>
 </div>
     
+      <div class="method_details ">
+  <h3 class="signature " id="transfer_settings-class_method">
+  
+    .<strong>transfer_settings</strong>  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>The library-wide settings as they are now: frozen copies of Files.default_headers (a Proc is kept as it is, and
+still called for each request), Files.language and Files.app_info, the timeouts, Files.region_policy, and
+Files.region_handler, kept as it is. A request given them uses them instead of the library-wide ones, and never
+falls back to Files.api_key or Files.session_id: a credential it was not given stays absent.</p>
+
   </div>
+</div>
+<div class="tags">
+  
 
-  <div id="instance_method_details" class="method_details_list">
-    <h2>Instance Method Details</h2>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+155
+156
+157
+158
+159
+160</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 155</span>
 
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_transfer_settings'>transfer_settings</span>
+  <span class='const'><span class='object_link'><a href="ApiClient/TransferSettings.html" title="Files::ApiClient::TransferSettings (class)">TransferSettings</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Files::ApiClient#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='label'>default_headers:</span> <span class='id identifier rubyid_settings_copy'>settings_copy</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_default_headers'><span class='object_link'><a href="../Files.html#default_headers-class_method" title="Files.default_headers (method)">default_headers</a></span></span><span class='rparen'>)</span><span class='comma'>,</span> <span class='label'>language:</span> <span class='id identifier rubyid_settings_copy'>settings_copy</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_language'><span class='object_link'><a href="../Files.html#language-class_method" title="Files.language (method)">language</a></span></span><span class='rparen'>)</span><span class='comma'>,</span> <span class='label'>app_info:</span> <span class='id identifier rubyid_settings_copy'>settings_copy</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_app_info'><span class='object_link'><a href="../Files.html#app_info-class_method" title="Files.app_info (method)">app_info</a></span></span><span class='rparen'>)</span><span class='comma'>,</span>
+                       <span class='label'>open_timeout:</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_open_timeout'><span class='object_link'><a href="../Files.html#open_timeout-class_method" title="Files.open_timeout (method)">open_timeout</a></span></span><span class='comma'>,</span> <span class='label'>read_timeout:</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_read_timeout'><span class='object_link'><a href="../Files.html#read_timeout-class_method" title="Files.read_timeout (method)">read_timeout</a></span></span><span class='comma'>,</span> <span class='label'>region_policy:</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_region_policy'><span class='object_link'><a href="../Files.html#region_policy-class_method" title="Files.region_policy (method)">region_policy</a></span></span><span class='comma'>,</span>
+                       <span class='label'>region_handler:</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_region_handler'><span class='object_link'><a href="../Files.html#region_handler-class_method" title="Files.region_handler (method)">region_handler</a></span></span>
+  <span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
     
-      <div class="method_details first">
-  <h3 class="signature first" id="cursor-instance_method">
+      <div class="method_details ">
+  <h3 class="signature " id="unchanged_default_conn?-class_method">
   
-    #<strong>cursor</strong>  &#x21d2; <tt>Object</tt> 
+    .<strong>unchanged_default_conn?</strong>(conn, proxy)  &#x21d2; <tt>Boolean</tt> 
   
 
   
 
   
-</h3><table class="source_code">
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Whether conn is a connection build_default_conn made with proxy, as proxy_identity gives it (nil when it was given
+none, so it follows the proxy environment variables), with nothing about it changed since: the same middleware and
+adapter (the same objects, so neither another adapter nor one with a configuration block of its own), and the same
+TLS, request and proxy options, default headers and default parameters. An adaptive transfer sends over its own
+connections, made with its own proxy, in place of only such a connection with that same proxy; through any other,
+such as one with a minimum TLS version or another proxy, it sends as that connection does.</p>
+
+  </div>
+</div>
+<div class="tags">
+  
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Boolean</tt>)</span>
+      
+      
+      
+    </li>
+  
+</ul>
+
+</div><table class="source_code">
   <tr>
     <td>
       <pre class="lines">
 
 
-319
-320
-321</pre>
+117
+118
+119
+120
+121</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 319</span>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 117</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_cursor'>cursor</span>
-  <span class='ivar'>@last_response</span><span class='period'>.</span><span class='id identifier rubyid_http_headers'>http_headers</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>x-files-cursor</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span>
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_unchanged_default_conn?'>unchanged_default_conn?</span><span class='lparen'>(</span><span class='id identifier rubyid_conn'>conn</span><span class='comma'>,</span> <span class='id identifier rubyid_proxy'>proxy</span><span class='rparen'>)</span>
+  <span class='kw'>return</span> <span class='kw'>false</span> <span class='kw'>unless</span> <span class='id identifier rubyid_conn'>conn</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>Faraday</span><span class='op'>::</span><span class='const'>Connection</span><span class='rparen'>)</span>
+
+  <span class='id identifier rubyid_conn'>conn</span><span class='period'>.</span><span class='id identifier rubyid_instance_variable_get'>instance_variable_get</span><span class='lparen'>(</span><span class='symbol'>:@files_sdk_configuration</span><span class='rparen'>)</span> <span class='op'>==</span> <span class='lbracket'>[</span> <span class='id identifier rubyid_connection_configuration'>connection_configuration</span><span class='lparen'>(</span><span class='id identifier rubyid_conn'>conn</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_proxy'>proxy</span> <span class='rbracket'>]</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -1039,9 +1366,9 @@ falling back to net_http.</p>
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="execute_request-instance_method">
+  <h3 class="signature " id="user_agent_with_metadata-class_method">
   
-    #<strong>execute_request</strong>(method, path, base_url: nil, api_key: nil, session_id: nil, workspace_id: nil, region_http_pairs: nil, headers: {}, params: {}, &amp;on_request_context)  &#x21d2; <tt>Object</tt> 
+    .<strong>user_agent_with_metadata</strong>(identity, host_os: , ruby_engine: RUBY_ENGINE, ruby_version: RUBY_VERSION)  &#x21d2; <tt>Object</tt> 
   
 
   
@@ -1049,10 +1376,15 @@ falling back to net_http.</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Returns the response and the API key and session ID the request used. <code>region_http_pairs</code>, such as the pairs a
-returned record keeps, is used instead of this client's. The block, if given, receives the request's context once
-its response has arrived: the regional origin a lockout region mismatch moved it to, or nil, and the frozen
-region_http_pairs it used.</p>
+    <p>The User-Agent the SDK sends with its own API requests: identity, the SDK's name and version and any app info,
+followed by one comment naming the coarse family of the operating system host_os (RbConfig's) names and the Ruby
+runtime, with ruby_version for CRuby, such as &quot;Files.com Ruby SDK v1.2.3 (files-sdk-meta/1; os=linux;
+runtime=ruby/3.4.4)&quot;. The comment carries nothing else: no host or user name, path, architecture or build. A
+version it cannot carry as given is left out rather than changed. When the whole User-Agent would be longer than
+190 bytes, the version is left out first and then the whole comment, so identity is always sent as it is; an
+identity that is not printable ASCII, such as one whose app info is not, gets no comment. A User-Agent from
+Files.default_headers or a request's own headers is sent instead, exactly as given, and a transfer request
+(remote_request) sends only the headers it is given.</p>
 
   </div>
 </div>
@@ -1065,43 +1397,6 @@ region_http_pairs it used.</p>
       <pre class="lines">
 
 
-150
-151
-152
-153
-154
-155
-156
-157
-158
-159
-160
-161
-162
-163
-164
-165
-166
-167
-168
-169
-170
-171
-172
-173
-174
-175
-176
-177
-178
-179
-180
-181
-182
-183
-184
-185
-186
 187
 188
 189
@@ -1113,30 +1408,219 @@ region_http_pairs it used.</p>
 195
 196
 197
-198
-199
-200
-201
-202
-203
-204
-205
-206
-207
-208
-209
-210
-211
-212
-213</pre>
+198</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 187</span>
+
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_user_agent_with_metadata'>user_agent_with_metadata</span><span class='lparen'>(</span><span class='id identifier rubyid_identity'>identity</span><span class='comma'>,</span> <span class='label'>host_os:</span> <span class='const'>RbConfig</span><span class='op'>::</span><span class='const'>CONFIG</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>host_os</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='label'>ruby_engine:</span> <span class='const'>RUBY_ENGINE</span><span class='comma'>,</span> <span class='label'>ruby_version:</span> <span class='const'>RUBY_VERSION</span><span class='rparen'>)</span>
+  <span class='kw'>return</span> <span class='id identifier rubyid_identity'>identity</span> <span class='kw'>unless</span> <span class='id identifier rubyid_identity'>identity</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>String</span><span class='rparen'>)</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_identity'>identity</span><span class='period'>.</span><span class='id identifier rubyid_ascii_only?'>ascii_only?</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_identity'>identity</span><span class='period'>.</span><span class='id identifier rubyid_match?'>match?</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>\A[\x20-\x7e]+\z</span><span class='regexp_end'>/</span></span><span class='rparen'>)</span>
+
+  <span class='id identifier rubyid_carried'>carried</span> <span class='op'>=</span> <span class='id identifier rubyid_ruby_engine'>ruby_engine</span> <span class='op'>==</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>ruby</span><span class='tstring_end'>&quot;</span></span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_ruby_version'>ruby_version</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>String</span><span class='rparen'>)</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_ruby_version'>ruby_version</span><span class='period'>.</span><span class='id identifier rubyid_ascii_only?'>ascii_only?</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_ruby_version'>ruby_version</span><span class='period'>.</span><span class='id identifier rubyid_match?'>match?</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>\A[0-9][A-Za-z0-9.+_-]{0,47}\z</span><span class='regexp_end'>/</span></span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_runtimes'>runtimes</span> <span class='op'>=</span> <span class='id identifier rubyid_carried'>carried</span> <span class='op'>?</span> <span class='lbracket'>[</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>ruby/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_ruby_version'>ruby_version</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>ruby</span><span class='tstring_end'>&quot;</span></span> <span class='rbracket'>]</span> <span class='op'>:</span> <span class='lbracket'>[</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>ruby</span><span class='tstring_end'>&quot;</span></span> <span class='rbracket'>]</span>
+  <span class='id identifier rubyid_os'>os</span> <span class='op'>=</span> <span class='id identifier rubyid_user_agent_os'>user_agent_os</span><span class='lparen'>(</span><span class='id identifier rubyid_host_os'>host_os</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_runtimes'>runtimes</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_runtime'>runtime</span><span class='op'>|</span>
+    <span class='id identifier rubyid_metadata'>metadata</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'> (</span><span class='embexpr_beg'>#{</span><span class='const'>USER_AGENT_METADATA_MARKER</span><span class='embexpr_end'>}</span><span class='tstring_content'>; os=</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_os'>os</span><span class='embexpr_end'>}</span><span class='tstring_content'>; runtime=</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_runtime'>runtime</span><span class='embexpr_end'>}</span><span class='tstring_content'>)</span><span class='tstring_end'>&quot;</span></span>
+    <span class='kw'>return</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_identity'>identity</span><span class='embexpr_end'>}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_metadata'>metadata</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id identifier rubyid_metadata'>metadata</span><span class='period'>.</span><span class='id identifier rubyid_bytesize'>bytesize</span> <span class='op'>&lt;=</span> <span class='const'>MAX_USER_AGENT_METADATA_BYTES</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_identity'>identity</span><span class='period'>.</span><span class='id identifier rubyid_bytesize'>bytesize</span> <span class='op'>+</span> <span class='id identifier rubyid_metadata'>metadata</span><span class='period'>.</span><span class='id identifier rubyid_bytesize'>bytesize</span> <span class='op'>&lt;=</span> <span class='const'>MAX_USER_AGENT_BYTES</span>
+  <span class='kw'>end</span>
+  <span class='id identifier rubyid_identity'>identity</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+  </div>
+
+  <div id="instance_method_details" class="method_details_list">
+    <h2>Instance Method Details</h2>
+
+    
+      <div class="method_details first">
+  <h3 class="signature first" id="cursor-instance_method">
+  
+    #<strong>cursor</strong>  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+474
+475
+476</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 474</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_cursor'>cursor</span>
+  <span class='ivar'>@last_response</span><span class='period'>.</span><span class='id identifier rubyid_http_headers'>http_headers</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>x-files-cursor</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="default_transfer_behavior?-instance_method">
+  
+    #<strong>default_transfer_behavior?</strong>  &#x21d2; <tt>Boolean</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Whether this client sends transfer requests just as the SDK's own default client does: an ApiClient itself, not
+a subclass or an object with methods of its own, with no logger or log level of its own. Only then may an
+adaptive transfer send its content requests over its own connections instead of through remote_request.</p>
+
+  </div>
+</div>
+<div class="tags">
+  
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Boolean</tt>)</span>
+      
+      
+      
+    </li>
+  
+</ul>
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+329
+330
+331</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 150</span>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 329</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_execute_request'>execute_request</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='comma'>,</span> <span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='label'>base_url:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>api_key:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>session_id:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>workspace_id:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>region_http_pairs:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>headers:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='label'>params:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_on_request_context'>on_request_context</span><span class='rparen'>)</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_default_transfer_behavior?'>default_transfer_behavior?</span>
+  <span class='id identifier rubyid_instance_of?'>instance_of?</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="" title="Files::ApiClient (class)">ApiClient</a></span></span><span class='rparen'>)</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_singleton_methods'>singleton_methods</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span> <span class='op'>&amp;&amp;</span> <span class='ivar'>@logger</span><span class='period'>.</span><span class='id identifier rubyid_equal?'>equal?</span><span class='lparen'>(</span><span class='const'>USE_GLOBAL</span><span class='rparen'>)</span> <span class='op'>&amp;&amp;</span> <span class='ivar'>@log_level</span><span class='period'>.</span><span class='id identifier rubyid_equal?'>equal?</span><span class='lparen'>(</span><span class='const'>USE_GLOBAL</span><span class='rparen'>)</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="execute_request-instance_method">
+  
+    #<strong>execute_request</strong>(method, path, base_url: nil, api_key: nil, session_id: nil, workspace_id: nil, region_http_pairs: nil, settings: nil, headers: {}, params: {}, &amp;on_request_context)  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Returns the response and the API key and session ID the request used. <code>region_http_pairs</code>, such as the pairs a
+returned record keeps, is used instead of this client's. <code>settings</code>, an adaptive transfer's TransferSettings, is
+used instead of the library-wide default headers, language, app info, timeouts and region policy and handler, and
+with it a credential the request was not given is not looked up in Files.api_key or Files.session_id. The block,
+if given, receives the request's context once its response has arrived: the regional origin a lockout region
+mismatch moved it to, or nil, and the frozen region_http_pairs it used.</p>
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+261
+262
+263
+264
+265
+266
+267
+268
+269
+270
+271
+272
+273
+274
+275
+276
+277
+278
+279
+280
+281
+282
+283
+284
+285
+286
+287
+288
+289
+290
+291
+292
+293
+294
+295
+296
+297
+298
+299
+300
+301
+302
+303
+304
+305
+306
+307
+308
+309
+310
+311
+312
+313
+314
+315
+316
+317
+318
+319
+320
+321
+322
+323
+324</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 261</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_execute_request'>execute_request</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='comma'>,</span> <span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='label'>base_url:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>api_key:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>session_id:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>workspace_id:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>region_http_pairs:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>settings:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>headers:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='label'>params:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_on_request_context'>on_request_context</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_base_url'>base_url</span> <span class='op'>||=</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_base_url'><span class='object_link'><a href="../Files.html#base_url-class_method" title="Files.base_url (method)">base_url</a></span></span>
   <span class='kw'>if</span> <span class='id identifier rubyid_api_key'>api_key</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
-    <span class='id identifier rubyid_session_id'>session_id</span> <span class='op'>||=</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_session_id'><span class='object_link'><a href="../Files.html#session_id-class_method" title="Files.session_id (method)">session_id</a></span></span>
+    <span class='id identifier rubyid_session_id'>session_id</span> <span class='op'>||=</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_session_id'><span class='object_link'><a href="../Files.html#session_id-class_method" title="Files.session_id (method)">session_id</a></span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_settings'>settings</span>
   <span class='kw'>else</span>
     <span class='id identifier rubyid_session_id'>session_id</span> <span class='op'>=</span> <span class='kw'>nil</span>
   <span class='kw'>end</span>
@@ -1145,7 +1629,7 @@ region_http_pairs it used.</p>
   <span class='kw'>if</span> <span class='id identifier rubyid_session_id'>session_id</span> <span class='kw'>and</span> <span class='id identifier rubyid_session_id'>session_id</span> <span class='op'>!=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span>
     <span class='id identifier rubyid_check_session_id!'>check_session_id!</span><span class='lparen'>(</span><span class='id identifier rubyid_session_id'>session_id</span><span class='rparen'>)</span>
   <span class='kw'>elsif</span> <span class='id identifier rubyid_path'>path</span> <span class='op'>!~</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>^\/sessions</span><span class='regexp_end'>/</span></span> <span class='comment'># TODO: automate this to refer to any unauthenticated endpoint
-</span>    <span class='id identifier rubyid_api_key'>api_key</span> <span class='op'>||=</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_api_key'><span class='object_link'><a href="../Files.html#api_key-class_method" title="Files.api_key (method)">api_key</a></span></span>
+</span>    <span class='id identifier rubyid_api_key'>api_key</span> <span class='op'>||=</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_api_key'><span class='object_link'><a href="../Files.html#api_key-class_method" title="Files.api_key (method)">api_key</a></span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_settings'>settings</span>
     <span class='id identifier rubyid_check_api_key!'>check_api_key!</span><span class='lparen'>(</span><span class='id identifier rubyid_api_key'>api_key</span><span class='rparen'>)</span>
   <span class='kw'>end</span>
 
@@ -1158,7 +1642,7 @@ region_http_pairs it used.</p>
     <span class='id identifier rubyid_body'>body</span> <span class='op'>=</span> <span class='id identifier rubyid_params'>params</span>
   <span class='kw'>end</span>
 
-  <span class='id identifier rubyid_headers'>headers</span> <span class='op'>=</span> <span class='id identifier rubyid_request_headers'>request_headers</span><span class='lparen'>(</span><span class='id identifier rubyid_api_key'>api_key</span><span class='comma'>,</span> <span class='id identifier rubyid_session_id'>session_id</span><span class='comma'>,</span> <span class='id identifier rubyid_method'>method</span><span class='comma'>,</span> <span class='id identifier rubyid_workspace_id'>workspace_id</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_update'>update</span><span class='lparen'>(</span><span class='id identifier rubyid_headers'>headers</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_headers'>headers</span> <span class='op'>=</span> <span class='id identifier rubyid_request_headers'>request_headers</span><span class='lparen'>(</span><span class='id identifier rubyid_api_key'>api_key</span><span class='comma'>,</span> <span class='id identifier rubyid_session_id'>session_id</span><span class='comma'>,</span> <span class='id identifier rubyid_method'>method</span><span class='comma'>,</span> <span class='id identifier rubyid_workspace_id'>workspace_id</span><span class='comma'>,</span> <span class='id identifier rubyid_settings'>settings</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_update'>update</span><span class='lparen'>(</span><span class='id identifier rubyid_headers'>headers</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_url'>url</span> <span class='op'>=</span> <span class='id identifier rubyid_api_url'>api_url</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='id identifier rubyid_base_url'>base_url</span><span class='rparen'>)</span>
 
   <span class='id identifier rubyid_context'>context</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="ApiClient/RequestLogContext.html" title="Files::ApiClient::RequestLogContext (class)">RequestLogContext</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Files::ApiClient#initialize (method)">new</a></span></span>
@@ -1174,15 +1658,15 @@ region_http_pairs it used.</p>
   <span class='comment'># Fixed before the request starts, so later changes to the caller&#39;s or the library-wide pairs cannot affect it.
 </span>  <span class='id identifier rubyid_http_pairs'>http_pairs</span> <span class='op'>=</span> <span class='id identifier rubyid_region_http_pairs'>region_http_pairs</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span> <span class='op'>?</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_region_http_pairs'>region_http_pairs</span> <span class='op'>:</span> <span class='const'><span class='object_link'><a href="Util.html" title="Files::Util (module)">Util</a></span></span><span class='period'>.</span><span class='id identifier rubyid_checked_region_http_pairs'><span class='object_link'><a href="Util.html#checked_region_http_pairs-class_method" title="Files::Util.checked_region_http_pairs (method)">checked_region_http_pairs</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_region_http_pairs'>region_http_pairs</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_relocate'>relocate</span> <span class='op'>=</span> <span class='id identifier rubyid_lambda'>lambda</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_error_response'>error_response</span><span class='op'>|</span>
-    <span class='id identifier rubyid_regional_base_url'>regional_base_url</span> <span class='op'>=</span> <span class='id identifier rubyid_region_continuation_base_url'>region_continuation_base_url</span><span class='lparen'>(</span><span class='id identifier rubyid_error_response'>error_response</span><span class='comma'>,</span> <span class='id identifier rubyid_base_url'>base_url</span><span class='comma'>,</span> <span class='id identifier rubyid_body'>body</span><span class='comma'>,</span> <span class='id identifier rubyid_http_pairs'>http_pairs</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_regional_base_url'>regional_base_url</span> <span class='op'>=</span> <span class='id identifier rubyid_region_continuation_base_url'>region_continuation_base_url</span><span class='lparen'>(</span><span class='id identifier rubyid_error_response'>error_response</span><span class='comma'>,</span> <span class='id identifier rubyid_base_url'>base_url</span><span class='comma'>,</span> <span class='id identifier rubyid_body'>body</span><span class='comma'>,</span> <span class='id identifier rubyid_http_pairs'>http_pairs</span><span class='comma'>,</span> <span class='id identifier rubyid_settings'>settings</span><span class='rparen'>)</span>
     <span class='id identifier rubyid_url'>url</span> <span class='op'>=</span> <span class='id identifier rubyid_api_url'>api_url</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='id identifier rubyid_regional_base_url'>regional_base_url</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_regional_base_url'>regional_base_url</span>
     <span class='id identifier rubyid_regional_base_url'>regional_base_url</span>
   <span class='kw'>end</span>
 
   <span class='id identifier rubyid_http_resp'>http_resp</span> <span class='op'>=</span> <span class='id identifier rubyid_execute_request_with_rescues'>execute_request_with_rescues</span><span class='lparen'>(</span><span class='id identifier rubyid_base_url'>base_url</span><span class='comma'>,</span> <span class='id identifier rubyid_context'>context</span><span class='comma'>,</span> <span class='label'>relocate:</span> <span class='id identifier rubyid_relocate'>relocate</span><span class='rparen'>)</span> <span class='kw'>do</span>
     <span class='id identifier rubyid_conn'>conn</span><span class='period'>.</span><span class='id identifier rubyid_run_request'>run_request</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='comma'>,</span> <span class='id identifier rubyid_url'>url</span><span class='comma'>,</span> <span class='id identifier rubyid_body'>body</span><span class='comma'>,</span> <span class='id identifier rubyid_headers'>headers</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_req'>req</span><span class='op'>|</span>
-      <span class='id identifier rubyid_req'>req</span><span class='period'>.</span><span class='id identifier rubyid_options'>options</span><span class='period'>.</span><span class='id identifier rubyid_open_timeout'>open_timeout</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_open_timeout'><span class='object_link'><a href="../Files.html#open_timeout-class_method" title="Files.open_timeout (method)">open_timeout</a></span></span>
-      <span class='id identifier rubyid_req'>req</span><span class='period'>.</span><span class='id identifier rubyid_options'>options</span><span class='period'>.</span><span class='id identifier rubyid_timeout'>timeout</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_read_timeout'><span class='object_link'><a href="../Files.html#read_timeout-class_method" title="Files.read_timeout (method)">read_timeout</a></span></span>
+      <span class='id identifier rubyid_req'>req</span><span class='period'>.</span><span class='id identifier rubyid_options'>options</span><span class='period'>.</span><span class='id identifier rubyid_open_timeout'>open_timeout</span> <span class='op'>=</span> <span class='id identifier rubyid_setting'>setting</span><span class='lparen'>(</span><span class='id identifier rubyid_settings'>settings</span><span class='comma'>,</span> <span class='symbol'>:open_timeout</span><span class='rparen'>)</span>
+      <span class='id identifier rubyid_req'>req</span><span class='period'>.</span><span class='id identifier rubyid_options'>options</span><span class='period'>.</span><span class='id identifier rubyid_timeout'>timeout</span> <span class='op'>=</span> <span class='id identifier rubyid_setting'>setting</span><span class='lparen'>(</span><span class='id identifier rubyid_settings'>settings</span><span class='comma'>,</span> <span class='symbol'>:read_timeout</span><span class='rparen'>)</span>
       <span class='id identifier rubyid_req'>req</span><span class='period'>.</span><span class='id identifier rubyid_params'>params</span> <span class='op'>=</span> <span class='id identifier rubyid_query_params'>query_params</span> <span class='kw'>unless</span> <span class='id identifier rubyid_query_params'>query_params</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
     <span class='kw'>end</span>
   <span class='kw'>end</span>
@@ -1228,63 +1712,65 @@ after count together.</p>
       <pre class="lines">
 
 
-483
-484
-485
-486
-487
-488
-489
-490
-491
-492
-493
-494
-495
-496
-497
-498
-499
-500
-501
-502
-503
-504
-505
-506
-507
-508
-509
-510
-511
-512
-513
-514
-515
-516
-517
-518
-519
-520
-521
-522
-523
-524
-525
-526
-527
-528
-529
-530
-531
-532
-533
-534
-535
-536</pre>
+640
+641
+642
+643
+644
+645
+646
+647
+648
+649
+650
+651
+652
+653
+654
+655
+656
+657
+658
+659
+660
+661
+662
+663
+664
+665
+666
+667
+668
+669
+670
+671
+672
+673
+674
+675
+676
+677
+678
+679
+680
+681
+682
+683
+684
+685
+686
+687
+688
+689
+690
+691
+692
+693
+694
+695</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 483</span>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 640</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_execute_request_with_rescues'>execute_request_with_rescues</span><span class='lparen'>(</span><span class='id identifier rubyid_base_url'>base_url</span><span class='comma'>,</span> <span class='id identifier rubyid_context'>context</span><span class='comma'>,</span> <span class='label'>skip_body_logging:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>is_transfer:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>relocate:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_num_retries'>num_retries</span> <span class='op'>=</span> <span class='int'>0</span>
@@ -1305,13 +1791,15 @@ after count together.</p>
       <span class='id identifier rubyid_log_response_error'>log_response_error</span><span class='lparen'>(</span><span class='id identifier rubyid_error_context'>error_context</span><span class='comma'>,</span> <span class='id identifier rubyid_request_start'>request_start</span><span class='comma'>,</span> <span class='id identifier rubyid_e'>e</span><span class='rparen'>)</span>
     <span class='kw'>end</span>
 
-    <span class='kw'>if</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_should_retry?'>should_retry?</span><span class='lparen'>(</span><span class='id identifier rubyid_e'>e</span><span class='comma'>,</span> <span class='id identifier rubyid_num_retries'>num_retries</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_single_attempt'>single_attempt</span> <span class='op'>=</span> <span class='id identifier rubyid_is_transfer'>is_transfer</span> <span class='op'>&amp;&amp;</span> <span class='const'>Thread</span><span class='period'>.</span><span class='id identifier rubyid_current'>current</span><span class='lbracket'>[</span><span class='symbol'>:files_api_client_single_attempt</span><span class='rbracket'>]</span>
+    <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_single_attempt'>single_attempt</span> <span class='op'>&amp;&amp;</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_should_retry?'>should_retry?</span><span class='lparen'>(</span><span class='id identifier rubyid_e'>e</span><span class='comma'>,</span> <span class='id identifier rubyid_num_retries'>num_retries</span><span class='rparen'>)</span>
       <span class='id identifier rubyid_num_retries'>num_retries</span> <span class='op'>+=</span> <span class='int'>1</span>
       <span class='id identifier rubyid_wait_seconds'>wait_seconds</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_sleep_time'>sleep_time</span><span class='lparen'>(</span><span class='id identifier rubyid_num_retries'>num_retries</span><span class='rparen'>)</span>
       <span class='id identifier rubyid_log_retry'>log_retry</span><span class='lparen'>(</span><span class='id identifier rubyid_context'>context</span><span class='comma'>,</span> <span class='id identifier rubyid_num_retries'>num_retries</span><span class='comma'>,</span> <span class='id identifier rubyid_e'>e</span><span class='comma'>,</span> <span class='id identifier rubyid_wait_seconds'>wait_seconds</span><span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id identifier rubyid_is_transfer'>is_transfer</span>
       <span class='id identifier rubyid_sleep'>sleep</span> <span class='id identifier rubyid_wait_seconds'>wait_seconds</span>
       <span class='kw'>retry</span>
     <span class='kw'>end</span>
+    <span class='id identifier rubyid_raise'>raise</span> <span class='kw'>if</span> <span class='id identifier rubyid_single_attempt'>single_attempt</span>
 
     <span class='const'><span class='object_link'><a href="Util.html" title="Files::Util (module)">Util</a></span></span><span class='period'>.</span><span class='id identifier rubyid_log_debug'><span class='object_link'><a href="Util.html#log_debug-class_method" title="Files::Util.log_debug (method)">log_debug</a></span></span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Transfer error details</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>error_message:</span> <span class='id identifier rubyid_e'>e</span><span class='period'>.</span><span class='id identifier rubyid_message'>message</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_is_transfer'>is_transfer</span>
 
@@ -1370,12 +1858,12 @@ own: the client's own, or Files.region_http_pairs.</p>
       <pre class="lines">
 
 
-142
-143
-144</pre>
+251
+252
+253</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 142</span>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 251</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_region_http_pairs'>region_http_pairs</span>
   <span class='ivar'>@region_http_pairs</span><span class='period'>.</span><span class='id identifier rubyid_equal?'>equal?</span><span class='lparen'>(</span><span class='const'>USE_GLOBAL</span><span class='rparen'>)</span> <span class='op'>?</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_region_http_pairs'><span class='object_link'><a href="../Files.html#region_http_pairs-class_method" title="Files.region_http_pairs (method)">region_http_pairs</a></span></span> <span class='op'>:</span> <span class='ivar'>@region_http_pairs</span>
@@ -1394,40 +1882,59 @@ own: the client's own, or Files.region_http_pairs.</p>
   
 
   
-</h3><table class="source_code">
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Sends a request to a transfer URL, such as a signed storage URL, through this client's connection, with its
+middleware, adapter, settings and logging. The URL's query reaches the adapter as URI parses it (SignedQuery): the
+request's params, the connection's default ones included, are not added to it, unlike an API request's. URI keeps
+its order, its percent escapes and the characters a signed URL's query uses, so such a query arrives exactly as
+given, as its signature needs; it escapes others, such as a space, and drops tabs and line breaks. A URL URI cannot
+parse, as one with %zz in its query or a character outside ASCII, is left to Faraday as it is, which refuses it
+or sends its query decoded and encoded again, as it does any params.</p>
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div><table class="source_code">
   <tr>
     <td>
       <pre class="lines">
 
 
-215
-216
-217
-218
-219
-220
-221
-222
-223
-224
-225
-226
-227
-228</pre>
+348
+349
+350
+351
+352
+353
+354
+355
+356
+357
+358
+359
+360
+361
+362
+363</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 215</span>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 348</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_remote_request'>remote_request</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='comma'>,</span> <span class='id identifier rubyid_url'>url</span><span class='comma'>,</span> <span class='id identifier rubyid_headers'>headers</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='id identifier rubyid_body'>body</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_context'>context</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="ApiClient/RequestLogContext.html" title="Files::ApiClient::RequestLogContext (class)">RequestLogContext</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Files::ApiClient#initialize (method)">new</a></span></span>
   <span class='id identifier rubyid_context'>context</span><span class='period'>.</span><span class='id identifier rubyid_method'>method</span>       <span class='op'>=</span> <span class='id identifier rubyid_method'>method</span>
   <span class='id identifier rubyid_context'>context</span><span class='period'>.</span><span class='id identifier rubyid_path'>path</span>         <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>[transfer]</span><span class='tstring_end'>&quot;</span></span>
   <span class='const'><span class='object_link'><a href="Util.html" title="Files::Util (module)">Util</a></span></span><span class='period'>.</span><span class='id identifier rubyid_log_debug'><span class='object_link'><a href="Util.html#log_debug-class_method" title="Files::Util.log_debug (method)">log_debug</a></span></span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Transfer request</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>method:</span> <span class='id identifier rubyid_method'>method</span><span class='comma'>,</span> <span class='label'>url:</span> <span class='id identifier rubyid_url'>url</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_query'>query</span> <span class='op'>=</span> <span class='id identifier rubyid_transfer_query'>transfer_query</span><span class='lparen'>(</span><span class='id identifier rubyid_url'>url</span><span class='rparen'>)</span>
 
   <span class='id identifier rubyid_execute_request_with_rescues'>execute_request_with_rescues</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_base_url'><span class='object_link'><a href="../Files.html#base_url-class_method" title="Files.base_url (method)">base_url</a></span></span><span class='comma'>,</span> <span class='id identifier rubyid_context'>context</span><span class='comma'>,</span> <span class='label'>skip_body_logging:</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='label'>is_transfer:</span> <span class='kw'>true</span><span class='rparen'>)</span> <span class='kw'>do</span>
     <span class='id identifier rubyid_conn'>conn</span><span class='period'>.</span><span class='id identifier rubyid_run_request'>run_request</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='comma'>,</span> <span class='id identifier rubyid_url'>url</span><span class='comma'>,</span> <span class='id identifier rubyid_body'>body</span><span class='comma'>,</span> <span class='id identifier rubyid_headers'>headers</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_req'>req</span><span class='op'>|</span>
       <span class='id identifier rubyid_req'>req</span><span class='period'>.</span><span class='id identifier rubyid_options'>options</span><span class='period'>.</span><span class='id identifier rubyid_open_timeout'>open_timeout</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_open_timeout'><span class='object_link'><a href="../Files.html#open_timeout-class_method" title="Files.open_timeout (method)">open_timeout</a></span></span>
       <span class='id identifier rubyid_req'>req</span><span class='period'>.</span><span class='id identifier rubyid_options'>options</span><span class='period'>.</span><span class='id identifier rubyid_timeout'>timeout</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Files.html" title="Files (module)">Files</a></span></span><span class='period'>.</span><span class='id identifier rubyid_read_timeout'><span class='object_link'><a href="../Files.html#read_timeout-class_method" title="Files.read_timeout (method)">read_timeout</a></span></span>
+      <span class='id identifier rubyid_req'>req</span><span class='period'>.</span><span class='id identifier rubyid_options'>options</span><span class='period'>.</span><span class='id identifier rubyid_params_encoder'>params_encoder</span> <span class='op'>=</span> <span class='const'>SignedQuery</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_query'>query</span><span class='comma'>,</span> <span class='id identifier rubyid_req'>req</span><span class='period'>.</span><span class='id identifier rubyid_options'>options</span><span class='period'>.</span><span class='id identifier rubyid_params_encoder'>params_encoder</span> <span class='op'>||</span> <span class='const'>Faraday</span><span class='op'>::</span><span class='const'>Utils</span><span class='period'>.</span><span class='id identifier rubyid_default_params_encoder'>default_params_encoder</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_query'>query</span>
       <span class='kw'>yield</span><span class='lparen'>(</span><span class='id identifier rubyid_req'>req</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_block_given?'>block_given?</span>
     <span class='kw'>end</span>
   <span class='kw'>end</span>
@@ -1452,21 +1959,21 @@ own: the client's own, or Files.region_http_pairs.</p>
       <pre class="lines">
 
 
-127
-128
-129
-130
-131
-132
-133
-134
-135
-136
-137
-138</pre>
+236
+237
+238
+239
+240
+241
+242
+243
+244
+245
+246
+247</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 127</span>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 236</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_request'>request</span>
   <span class='ivar'>@last_response</span> <span class='op'>=</span> <span class='kw'>nil</span>
@@ -1483,6 +1990,49 @@ own: the client's own, or Files.region_http_pairs.</p>
     </td>
   </tr>
 </table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="resolved_workspace_id-instance_method">
+  
+    #<strong>resolved_workspace_id</strong>  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>The workspace_id option that names, for every later request, the workspace this client's requests name now when
+their own workspace_id is nil: its own, or Files.workspace_id, and &quot;&quot; for none. An adaptive upload fixes it as it
+begins, so a later change to Files.workspace_id cannot move it.</p>
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+336
+337
+338
+339</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 336</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_resolved_workspace_id'>resolved_workspace_id</span>
+  <span class='id identifier rubyid_workspace_id'>workspace_id</span> <span class='op'>=</span> <span class='id identifier rubyid_default_workspace_id'>default_workspace_id</span>
+  <span class='id identifier rubyid_workspace_id'>workspace_id</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span> <span class='op'>?</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span> <span class='op'>:</span> <span class='id identifier rubyid_workspace_id'>workspace_id</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
     
       <div class="method_details ">
@@ -1500,24 +2050,26 @@ own: the client's own, or Files.region_http_pairs.</p>
       <pre class="lines">
 
 
-230
-231
-232
-233
-234
-235
-236
-237
-238</pre>
+373
+374
+375
+376
+377
+378
+379
+380
+381
+382</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 230</span>
+      <pre class="code"><span class="info file"># File 'lib/files.com/api_client.rb', line 373</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_stream_download'>stream_download</span><span class='lparen'>(</span><span class='id identifier rubyid_uri'>uri</span><span class='comma'>,</span> <span class='id identifier rubyid_io'>io</span><span class='comma'>,</span> <span class='id identifier rubyid_range'>range</span><span class='rparen'>)</span>
   <span class='kw'>if</span> <span class='id identifier rubyid_conn'>conn</span><span class='period'>.</span><span class='id identifier rubyid_adapter'>adapter</span> <span class='op'>==</span> <span class='const'>Faraday</span><span class='op'>::</span><span class='const'>Adapter</span><span class='op'>::</span><span class='const'>NetHttp</span>
     <span class='id identifier rubyid_stream_download_with_net_http'>stream_download_with_net_http</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="URI.html" title="Files::URI (module)">URI</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_uri'>uri</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_io'>io</span><span class='comma'>,</span> <span class='id identifier rubyid_range'>range</span><span class='rparen'>)</span>
   <span class='kw'>else</span>
     <span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='id identifier rubyid_remote_request'>remote_request</span><span class='lparen'>(</span><span class='symbol'>:get</span><span class='comma'>,</span> <span class='id identifier rubyid_uri'>uri</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_reject_frontend_response'>reject_frontend_response</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_headers'>headers</span><span class='period'>.</span><span class='id identifier rubyid_key?'>key?</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="Transfer.html" title="Files::Transfer (module)">Transfer</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Transfer/StorageRetry.html" title="Files::Transfer::StorageRetry (module)">StorageRetry</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Transfer/StorageRetry.html#FRONTEND_HEADER-constant" title="Files::Transfer::StorageRetry::FRONTEND_HEADER (constant)">FRONTEND_HEADER</a></span></span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_io'>io</span><span class='rparen'>)</span>
     <span class='id identifier rubyid_io'>io</span><span class='period'>.</span><span class='id identifier rubyid_fulfill_content_length'>fulfill_content_length</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_content_length'>content_length</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_io'>io</span><span class='period'>.</span><span class='id identifier rubyid_respond_to?'>respond_to?</span><span class='lparen'>(</span><span class='symbol'>:fulfill_content_length</span><span class='rparen'>)</span>
     <span class='id identifier rubyid_io'>io</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_body'>body</span><span class='rparen'>)</span>
   <span class='kw'>end</span>
@@ -1532,7 +2084,7 @@ own: the client's own, or Files.region_http_pairs.</p>
 </div>
 
       <div id="footer">
-  Generated on Tue Nov  3 14:26:12 2026 by
+  Generated on Tue Nov  3 18:03:57 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.45 (ruby-4.0.9).
 </div>