hanzoai 8.5.156

data/lib/hanzoai/api/sandbox_api.rb

@@ -0,0 +1,1252 @@
+=begin
+#Hanzo Cloud API
+
+#The Hanzo Cloud API as a customer calls it: every operation under /v1/ except the operator's admin product, relay routes, legacy spellings and capabilities still reached by flag. Tagged by product: the first path segment after /v1/.
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+require 'cgi'
+
+module Hanzoai
+  class SandboxApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Ends a sandbox and releases the compute behind it.
+    # Ends a sandbox and releases the compute behind it. Answers 204.  ENDING IS NOT STOPPING. This releases the resource: the pod goes and anything only inside it goes with it. To end what a sandbox is RUNNING while keeping the sandbox — the checkout, the logs, the half-written file — the verb is POST /v1/sandbox/stop.  `?purge=1` additionally removes the record, so the sandbox stops being listed at all rather than being listed as ended.
+    # @param id [String] ID is the sandbox to end, from the path.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :purge 
+    # @return [nil]
+    def delete_sandbox_by_id(id, opts = {})
+      delete_sandbox_by_id_with_http_info(id, opts)
+      nil
+    end
+
+    # Ends a sandbox and releases the compute behind it.
+    # Ends a sandbox and releases the compute behind it. Answers 204.  ENDING IS NOT STOPPING. This releases the resource: the pod goes and anything only inside it goes with it. To end what a sandbox is RUNNING while keeping the sandbox — the checkout, the logs, the half-written file — the verb is POST /v1/sandbox/stop.  `?purge=1` additionally removes the record, so the sandbox stops being listed at all rather than being listed as ended.
+    # @param id [String] ID is the sandbox to end, from the path.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :purge 
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_sandbox_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.delete_sandbox_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SandboxApi.delete_sandbox_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'purge'] = opts[:'purge'] if !opts[:'purge'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.delete_sandbox_by_id",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#delete_sandbox_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # End a sandbox and release it
+    # Ends the caller's sandbox lease: the pod goes, and the volume goes only when the caller asked for that too.
+    # @param end_in [EndIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def end_sandbox(end_in, opts = {})
+      end_sandbox_with_http_info(end_in, opts)
+      nil
+    end
+
+    # End a sandbox and release it
+    # Ends the caller&#39;s sandbox lease: the pod goes, and the volume goes only when the caller asked for that too.
+    # @param end_in [EndIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def end_sandbox_with_http_info(end_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.end_sandbox ...'
+      end
+      # verify the required parameter 'end_in' is set
+      if @api_client.config.client_side_validation && end_in.nil?
+        fail ArgumentError, "Missing the required parameter 'end_in' when calling SandboxApi.end_sandbox"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/end'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(end_in)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.end_sandbox",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#end_sandbox\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Lists the caller org's sandboxes, newest first.
+    # Lists the caller org's sandboxes, newest first.  `?project=` and `?status=` narrow it. Only the caller's org's: the store is keyed on the validated org, so another tenant's sandbox is not something this operation can return.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :project 
+    # @option opts [String] :status 
+    # @return [SandboxList]
+    def get_sandbox(opts = {})
+      data, _status_code, _headers = get_sandbox_with_http_info(opts)
+      data
+    end
+
+    # Lists the caller org&#39;s sandboxes, newest first.
+    # Lists the caller org&#39;s sandboxes, newest first.  &#x60;?project&#x3D;&#x60; and &#x60;?status&#x3D;&#x60; narrow it. Only the caller&#39;s org&#39;s: the store is keyed on the validated org, so another tenant&#39;s sandbox is not something this operation can return.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :project 
+    # @option opts [String] :status 
+    # @return [Array<(SandboxList, Integer, Hash)>] SandboxList data, response status code and response headers
+    def get_sandbox_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.get_sandbox ...'
+      end
+      # resource path
+      local_var_path = '/v1/sandbox'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'project'] = opts[:'project'] if !opts[:'project'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SandboxList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.get_sandbox",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#get_sandbox\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one sandbox: its class, project, image, the runtime it was given, its status and when its lease ends.
+    # Returns one sandbox: its class, project, image, the runtime it was given, its status and when its lease ends.  An id the caller's org does not hold is the same 404 an unknown id gives — the store is keyed on the org, so a cross-tenant id simply is not there.
+    # @param id [String] ID is the sandbox to address, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Sandbox]
+    def get_sandbox_by_id(id, opts = {})
+      data, _status_code, _headers = get_sandbox_by_id_with_http_info(id, opts)
+      data
+    end
+
+    # Returns one sandbox: its class, project, image, the runtime it was given, its status and when its lease ends.
+    # Returns one sandbox: its class, project, image, the runtime it was given, its status and when its lease ends.  An id the caller&#39;s org does not hold is the same 404 an unknown id gives — the store is keyed on the org, so a cross-tenant id simply is not there.
+    # @param id [String] ID is the sandbox to address, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Sandbox, Integer, Hash)>] Sandbox data, response status code and response headers
+    def get_sandbox_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.get_sandbox_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SandboxApi.get_sandbox_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Sandbox'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.get_sandbox_by_id",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#get_sandbox_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Read a file, or list a directory
+    # Reads one file from the sandbox's project directory as text, or lists the entries when the path names a directory. Paths resolve under the project root and a path that climbs out is refused rather than rewritten.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_sandbox_by_id_fs(id, opts = {})
+      get_sandbox_by_id_fs_with_http_info(id, opts)
+      nil
+    end
+
+    # Read a file, or list a directory
+    # Reads one file from the sandbox&#39;s project directory as text, or lists the entries when the path names a directory. Paths resolve under the project root and a path that climbs out is refused rather than rewritten.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_sandbox_by_id_fs_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.get_sandbox_by_id_fs ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SandboxApi.get_sandbox_by_id_fs"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/{id}/fs'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.get_sandbox_by_id_fs",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#get_sandbox_by_id_fs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # The screen, as a page
+    # A complete, self-contained desktop — noVNC inline, no other origin — that opens its own socket and draws this sandbox's display. Embed it in an iframe and there is nothing else to build.  `ticket` is the credential from the POST above, carried through to the socket. The page is NOT gated: it is inert markup and does not redeem the ticket, because a ticket is spent once and a page that spent it would hold a credential that no longer opens anything. `frame-ancestors` admits our own brands' hosts and nothing further.  It is served for every class, not only for `desktop`. The class is a fact about the image, and a sandbox with no VNC server already fails exactly — the connection is refused and the page says so — where a check here would be a second opinion about what is running inside a pod, formed from a label rather than from the pod.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_sandbox_by_id_screen(id, opts = {})
+      get_sandbox_by_id_screen_with_http_info(id, opts)
+      nil
+    end
+
+    # The screen, as a page
+    # A complete, self-contained desktop — noVNC inline, no other origin — that opens its own socket and draws this sandbox&#39;s display. Embed it in an iframe and there is nothing else to build.  &#x60;ticket&#x60; is the credential from the POST above, carried through to the socket. The page is NOT gated: it is inert markup and does not redeem the ticket, because a ticket is spent once and a page that spent it would hold a credential that no longer opens anything. &#x60;frame-ancestors&#x60; admits our own brands&#39; hosts and nothing further.  It is served for every class, not only for &#x60;desktop&#x60;. The class is a fact about the image, and a sandbox with no VNC server already fails exactly — the connection is refused and the page says so — where a check here would be a second opinion about what is running inside a pod, formed from a label rather than from the pod.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_sandbox_by_id_screen_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.get_sandbox_by_id_screen ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SandboxApi.get_sandbox_by_id_screen"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/{id}/screen'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.get_sandbox_by_id_screen",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#get_sandbox_by_id_screen\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # The screen, as a socket
+    # Upgrades to a WebSocket carrying RFB — the VNC wire protocol — from the sandbox's display, for a host that brings its own client. Requires `ticket`; a missing, expired or already-spent one answers 401 without upgrading.  THE WIRE IS RFB, in BINARY frames both ways, and it is not interpreted here: this is a pipe between the caller's client and the server inside the pod.  THE PIXELS COME OUT THROUGH THE EXEC CHANNEL. The display binds 127.0.0.1 only and deliberately nothing else, so there is no address to dial — `socat` joins the stream to that loopback port over the same Kubernetes exec subresource every other call into a sandbox uses. One way in, one thing to authorize, nothing further exposed.  The window size is ignored. A browser pane is not the X server's geometry, and the client scales what it is given rather than asking a server with no RandR to resize itself.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_sandbox_by_id_screen_ws(id, opts = {})
+      get_sandbox_by_id_screen_ws_with_http_info(id, opts)
+      nil
+    end
+
+    # The screen, as a socket
+    # Upgrades to a WebSocket carrying RFB — the VNC wire protocol — from the sandbox&#39;s display, for a host that brings its own client. Requires &#x60;ticket&#x60;; a missing, expired or already-spent one answers 401 without upgrading.  THE WIRE IS RFB, in BINARY frames both ways, and it is not interpreted here: this is a pipe between the caller&#39;s client and the server inside the pod.  THE PIXELS COME OUT THROUGH THE EXEC CHANNEL. The display binds 127.0.0.1 only and deliberately nothing else, so there is no address to dial — &#x60;socat&#x60; joins the stream to that loopback port over the same Kubernetes exec subresource every other call into a sandbox uses. One way in, one thing to authorize, nothing further exposed.  The window size is ignored. A browser pane is not the X server&#39;s geometry, and the client scales what it is given rather than asking a server with no RandR to resize itself.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_sandbox_by_id_screen_ws_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.get_sandbox_by_id_screen_ws ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SandboxApi.get_sandbox_by_id_screen_ws"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/{id}/screen/ws'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.get_sandbox_by_id_screen_ws",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#get_sandbox_by_id_screen_ws\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # The terminal, as a page
+    # A complete, self-contained terminal — xterm inline, no other origin — that opens its own socket and runs a shell in this sandbox. Embed it in an iframe and there is nothing else to build.  `ticket` is the credential from the POST above and `arg` names the session (see the socket below); both are simply carried through to the socket. The page is NOT gated — it is inert markup and does not redeem the ticket, because a ticket is spent once and a page that spent it would hold a credential that no longer opens anything.  When the terminal is up it posts `{source:\"hanzo-term\", ready:true}` to its parent frame, so a host can tell a live terminal from a page that failed into something else. `frame-ancestors` admits our own brands' hosts and nothing further.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_sandbox_by_id_terminal(id, opts = {})
+      get_sandbox_by_id_terminal_with_http_info(id, opts)
+      nil
+    end
+
+    # The terminal, as a page
+    # A complete, self-contained terminal — xterm inline, no other origin — that opens its own socket and runs a shell in this sandbox. Embed it in an iframe and there is nothing else to build.  &#x60;ticket&#x60; is the credential from the POST above and &#x60;arg&#x60; names the session (see the socket below); both are simply carried through to the socket. The page is NOT gated — it is inert markup and does not redeem the ticket, because a ticket is spent once and a page that spent it would hold a credential that no longer opens anything.  When the terminal is up it posts &#x60;{source:\&quot;hanzo-term\&quot;, ready:true}&#x60; to its parent frame, so a host can tell a live terminal from a page that failed into something else. &#x60;frame-ancestors&#x60; admits our own brands&#39; hosts and nothing further.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_sandbox_by_id_terminal_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.get_sandbox_by_id_terminal ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SandboxApi.get_sandbox_by_id_terminal"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/{id}/terminal'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.get_sandbox_by_id_terminal",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#get_sandbox_by_id_terminal\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # The terminal, as a socket
+    # Upgrades to a WebSocket carrying a login shell on a pseudo-terminal inside the sandbox — for a host that brings its own emulator. Requires `ticket`; a missing, expired or already-spent one answers 401 without upgrading.  THE WIRE. A text frame is stdin, unless it is the one control object `{\"resize\":{\"cols\":N,\"rows\":M}}`; a binary frame is always stdin. Output comes back as BINARY frames, because a pty emits arbitrary bytes cut at arbitrary offsets and a text frame carrying half a rune is one the browser closes the connection over.  `arg` names a SESSION: the shell runs under `tmux new -A -s <arg>`, which attaches to that session if it exists and creates it if it does not — so one sandbox holds as many terminals as a caller has names for. It is 1-64 characters of letters, digits, `-` or `_` and may not begin with `-`; anything else is 400. Without `arg` the shell is unnamed and unmultiplexed.  The shell is `zsh -l`, falling back to `bash -l` and then to `sh -l`, and to the plain shell again when the image has no tmux. Every step is a preference and none is a requirement: whatever else the image carries — the hanzo CLI included — is a command to type, never a condition for getting a prompt.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def get_sandbox_by_id_terminal_ws(id, opts = {})
+      get_sandbox_by_id_terminal_ws_with_http_info(id, opts)
+      nil
+    end
+
+    # The terminal, as a socket
+    # Upgrades to a WebSocket carrying a login shell on a pseudo-terminal inside the sandbox — for a host that brings its own emulator. Requires &#x60;ticket&#x60;; a missing, expired or already-spent one answers 401 without upgrading.  THE WIRE. A text frame is stdin, unless it is the one control object &#x60;{\&quot;resize\&quot;:{\&quot;cols\&quot;:N,\&quot;rows\&quot;:M}}&#x60;; a binary frame is always stdin. Output comes back as BINARY frames, because a pty emits arbitrary bytes cut at arbitrary offsets and a text frame carrying half a rune is one the browser closes the connection over.  &#x60;arg&#x60; names a SESSION: the shell runs under &#x60;tmux new -A -s &lt;arg&gt;&#x60;, which attaches to that session if it exists and creates it if it does not — so one sandbox holds as many terminals as a caller has names for. It is 1-64 characters of letters, digits, &#x60;-&#x60; or &#x60;_&#x60; and may not begin with &#x60;-&#x60;; anything else is 400. Without &#x60;arg&#x60; the shell is unnamed and unmultiplexed.  The shell is &#x60;zsh -l&#x60;, falling back to &#x60;bash -l&#x60; and then to &#x60;sh -l&#x60;, and to the plain shell again when the image has no tmux. Every step is a preference and none is a requirement: whatever else the image carries — the hanzo CLI included — is a command to type, never a condition for getting a prompt.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_sandbox_by_id_terminal_ws_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.get_sandbox_by_id_terminal_ws ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SandboxApi.get_sandbox_by_id_terminal_ws"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/{id}/terminal/ws'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.get_sandbox_by_id_terminal_ws",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#get_sandbox_by_id_terminal_ws\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Lease a sandbox — a real computer — or resume one you hold
+    # Leases the caller's sandbox, or returns the one it named if that lease is still running.  What comes back is a real computer: a pod under a runtime boundary with a toolchain already in it, its own filesystem, and a lease that ends it. Every other op here acts on the one this returns.
+    # @param lease_in [LeaseIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Leased]
+    def lease_sandbox(lease_in, opts = {})
+      data, _status_code, _headers = lease_sandbox_with_http_info(lease_in, opts)
+      data
+    end
+
+    # Lease a sandbox — a real computer — or resume one you hold
+    # Leases the caller&#39;s sandbox, or returns the one it named if that lease is still running.  What comes back is a real computer: a pod under a runtime boundary with a toolchain already in it, its own filesystem, and a lease that ends it. Every other op here acts on the one this returns.
+    # @param lease_in [LeaseIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Leased, Integer, Hash)>] Leased data, response status code and response headers
+    def lease_sandbox_with_http_info(lease_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.lease_sandbox ...'
+      end
+      # verify the required parameter 'lease_in' is set
+      if @api_client.config.client_side_validation && lease_in.nil?
+        fail ArgumentError, "Missing the required parameter 'lease_in' when calling SandboxApi.lease_sandbox"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/lease'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(lease_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Leased'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.lease_sandbox",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#lease_sandbox\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Leases a sandbox — a real computer — for the caller's org.
+    # Leases a sandbox — a real computer — for the caller's org.  The class decides what it is for and therefore its image, working directory and isolation. A dev or desktop sandbox is SINGLE-ATTACH per project, so asking twice for one project resumes the one that exists rather than paying for a second; an exec sandbox carries no project and is bounded per org instead, refused 429 past the ceiling because the caller's correct response is to wait.  Answers 201 with the sandbox as leased, which names the runtime it GOT — not the one that was asked for.
+    # @param lease_in [LeaseIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Sandbox]
+    def post_sandbox(lease_in, opts = {})
+      data, _status_code, _headers = post_sandbox_with_http_info(lease_in, opts)
+      data
+    end
+
+    # Leases a sandbox — a real computer — for the caller&#39;s org.
+    # Leases a sandbox — a real computer — for the caller&#39;s org.  The class decides what it is for and therefore its image, working directory and isolation. A dev or desktop sandbox is SINGLE-ATTACH per project, so asking twice for one project resumes the one that exists rather than paying for a second; an exec sandbox carries no project and is bounded per org instead, refused 429 past the ceiling because the caller&#39;s correct response is to wait.  Answers 201 with the sandbox as leased, which names the runtime it GOT — not the one that was asked for.
+    # @param lease_in [LeaseIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Sandbox, Integer, Hash)>] Sandbox data, response status code and response headers
+    def post_sandbox_with_http_info(lease_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.post_sandbox ...'
+      end
+      # verify the required parameter 'lease_in' is set
+      if @api_client.config.client_side_validation && lease_in.nil?
+        fail ArgumentError, "Missing the required parameter 'lease_in' when calling SandboxApi.post_sandbox"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(lease_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Sandbox'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.post_sandbox",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#post_sandbox\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Runs one command in a sandbox the caller holds and answers with its exit code, stdout and stderr.
+    # Runs one command in a sandbox the caller holds and answers with its exit code, stdout and stderr.  Send `argv` — an argument vector cannot be word-split by accident — or `command` for a shell line, which is the only input here that ever reaches a shell. A non-zero exit is a SUCCESSFUL call carrying a failed command: the status is 200 and the exit code is in the answer, because \"the command failed\" and \"the call failed\" are different facts.
+    # @param id [String] ID is the sandbox to run in, from the path.
+    # @param exec_request [ExecRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [ExecResult]
+    def post_sandbox_by_id_exec(id, exec_request, opts = {})
+      data, _status_code, _headers = post_sandbox_by_id_exec_with_http_info(id, exec_request, opts)
+      data
+    end
+
+    # Runs one command in a sandbox the caller holds and answers with its exit code, stdout and stderr.
+    # Runs one command in a sandbox the caller holds and answers with its exit code, stdout and stderr.  Send &#x60;argv&#x60; — an argument vector cannot be word-split by accident — or &#x60;command&#x60; for a shell line, which is the only input here that ever reaches a shell. A non-zero exit is a SUCCESSFUL call carrying a failed command: the status is 200 and the exit code is in the answer, because \&quot;the command failed\&quot; and \&quot;the call failed\&quot; are different facts.
+    # @param id [String] ID is the sandbox to run in, from the path.
+    # @param exec_request [ExecRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ExecResult, Integer, Hash)>] ExecResult data, response status code and response headers
+    def post_sandbox_by_id_exec_with_http_info(id, exec_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.post_sandbox_by_id_exec ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SandboxApi.post_sandbox_by_id_exec"
+      end
+      # verify the required parameter 'exec_request' is set
+      if @api_client.config.client_side_validation && exec_request.nil?
+        fail ArgumentError, "Missing the required parameter 'exec_request' when calling SandboxApi.post_sandbox_by_id_exec"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/{id}/exec'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(exec_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ExecResult'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.post_sandbox_by_id_exec",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#post_sandbox_by_id_exec\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Write a file
+    # Writes the request body to one file in the sandbox's project directory, creating parent directories. Same confinement as the read above.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def post_sandbox_by_id_fs(id, opts = {})
+      post_sandbox_by_id_fs_with_http_info(id, opts)
+      nil
+    end
+
+    # Write a file
+    # Writes the request body to one file in the sandbox&#39;s project directory, creating parent directories. Same confinement as the read above.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_sandbox_by_id_fs_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.post_sandbox_by_id_fs ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SandboxApi.post_sandbox_by_id_fs"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/{id}/fs'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.post_sandbox_by_id_fs",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#post_sandbox_by_id_fs\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Mints a short-lived grant to open the screen of a desktop sandbox.
+    # Mints a short-lived grant to open the screen of a desktop sandbox. Same properties as the terminal ticket, for the other endpoint.
+    # @param id [String] ID is the sandbox to address, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [TicketGrant]
+    def post_sandbox_by_id_screen_ticket(id, opts = {})
+      data, _status_code, _headers = post_sandbox_by_id_screen_ticket_with_http_info(id, opts)
+      data
+    end
+
+    # Mints a short-lived grant to open the screen of a desktop sandbox.
+    # Mints a short-lived grant to open the screen of a desktop sandbox. Same properties as the terminal ticket, for the other endpoint.
+    # @param id [String] ID is the sandbox to address, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TicketGrant, Integer, Hash)>] TicketGrant data, response status code and response headers
+    def post_sandbox_by_id_screen_ticket_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.post_sandbox_by_id_screen_ticket ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SandboxApi.post_sandbox_by_id_screen_ticket"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/{id}/screen/ticket'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TicketGrant'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.post_sandbox_by_id_screen_ticket",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#post_sandbox_by_id_screen_ticket\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Mints a short-lived grant to open a terminal on a sandbox.
+    # Mints a short-lived grant to open a terminal on a sandbox.  The ticket travels in the query string of the URL it answers with, because a browser cannot set an Authorization header on a WebSocket handshake. It is single-purpose and short-lived for exactly that reason. A sandbox that is not running is 409 rather than a ticket that cannot be used.
+    # @param id [String] ID is the sandbox to address, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [TicketGrant]
+    def post_sandbox_by_id_terminal_ticket(id, opts = {})
+      data, _status_code, _headers = post_sandbox_by_id_terminal_ticket_with_http_info(id, opts)
+      data
+    end
+
+    # Mints a short-lived grant to open a terminal on a sandbox.
+    # Mints a short-lived grant to open a terminal on a sandbox.  The ticket travels in the query string of the URL it answers with, because a browser cannot set an Authorization header on a WebSocket handshake. It is single-purpose and short-lived for exactly that reason. A sandbox that is not running is 409 rather than a ticket that cannot be used.
+    # @param id [String] ID is the sandbox to address, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TicketGrant, Integer, Hash)>] TicketGrant data, response status code and response headers
+    def post_sandbox_by_id_terminal_ticket_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.post_sandbox_by_id_terminal_ticket ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SandboxApi.post_sandbox_by_id_terminal_ticket"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/{id}/terminal/ticket'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TicketGrant'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.post_sandbox_by_id_terminal_ticket",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#post_sandbox_by_id_terminal_ticket\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Read a file from a sandbox you hold
+    # Reads one path in the caller's sandbox: a file's bytes, or a directory's entries when the path names one.
+    # @param path_in [PathIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Blob]
+    def read_sandbox_file(path_in, opts = {})
+      data, _status_code, _headers = read_sandbox_file_with_http_info(path_in, opts)
+      data
+    end
+
+    # Read a file from a sandbox you hold
+    # Reads one path in the caller&#39;s sandbox: a file&#39;s bytes, or a directory&#39;s entries when the path names one.
+    # @param path_in [PathIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Blob, Integer, Hash)>] Blob data, response status code and response headers
+    def read_sandbox_file_with_http_info(path_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.read_sandbox_file ...'
+      end
+      # verify the required parameter 'path_in' is set
+      if @api_client.config.client_side_validation && path_in.nil?
+        fail ArgumentError, "Missing the required parameter 'path_in' when calling SandboxApi.read_sandbox_file"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/read'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(path_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Blob'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.read_sandbox_file",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#read_sandbox_file\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Run a command in a sandbox you hold and read its output
+    # Runs one command inside the caller's sandbox and answers its exit code, stdout and stderr. A non-zero exit is a successful call carrying a failed program, so it comes back as data and not as an error.  Name a `session` and the command NARRATES INTO IT: its output is appended to that session's live log as the program produces it, so anything watching the session — GET /v1/agents/sessions/stream, scoped to one run with ?root= — watches the work happen rather than waiting for the verdict. Without it the call is what it always was: silent until it returns, which for an agentic run is twenty-five minutes of blank screen.  The session is named; the TENANT is not. It is the org the caller already proved, so a session belonging to somebody else is absent from the org this call acts for and the append is refused there.
+    # @param run_in [RunIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Ran]
+    def run_in_sandbox(run_in, opts = {})
+      data, _status_code, _headers = run_in_sandbox_with_http_info(run_in, opts)
+      data
+    end
+
+    # Run a command in a sandbox you hold and read its output
+    # Runs one command inside the caller&#39;s sandbox and answers its exit code, stdout and stderr. A non-zero exit is a successful call carrying a failed program, so it comes back as data and not as an error.  Name a &#x60;session&#x60; and the command NARRATES INTO IT: its output is appended to that session&#39;s live log as the program produces it, so anything watching the session — GET /v1/agents/sessions/stream, scoped to one run with ?root&#x3D; — watches the work happen rather than waiting for the verdict. Without it the call is what it always was: silent until it returns, which for an agentic run is twenty-five minutes of blank screen.  The session is named; the TENANT is not. It is the org the caller already proved, so a session belonging to somebody else is absent from the org this call acts for and the append is refused there.
+    # @param run_in [RunIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Ran, Integer, Hash)>] Ran data, response status code and response headers
+    def run_in_sandbox_with_http_info(run_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.run_in_sandbox ...'
+      end
+      # verify the required parameter 'run_in' is set
+      if @api_client.config.client_side_validation && run_in.nil?
+        fail ArgumentError, "Missing the required parameter 'run_in' when calling SandboxApi.run_in_sandbox"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/run'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(run_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Ran'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.run_in_sandbox",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#run_in_sandbox\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Stop what a sandbox is running, and keep the sandbox
+    # Interrupts whatever the caller's sandbox is running and answers how many commands it ended. The sandbox stays leased — stop ends the WORK, end ends the RESOURCE — so whoever stopped a run can still read what it left behind.
+    # @param stop_in [StopIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Stopped]
+    def stop_run(stop_in, opts = {})
+      data, _status_code, _headers = stop_run_with_http_info(stop_in, opts)
+      data
+    end
+
+    # Stop what a sandbox is running, and keep the sandbox
+    # Interrupts whatever the caller&#39;s sandbox is running and answers how many commands it ended. The sandbox stays leased — stop ends the WORK, end ends the RESOURCE — so whoever stopped a run can still read what it left behind.
+    # @param stop_in [StopIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Stopped, Integer, Hash)>] Stopped data, response status code and response headers
+    def stop_run_with_http_info(stop_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.stop_run ...'
+      end
+      # verify the required parameter 'stop_in' is set
+      if @api_client.config.client_side_validation && stop_in.nil?
+        fail ArgumentError, "Missing the required parameter 'stop_in' when calling SandboxApi.stop_run"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/stop'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(stop_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Stopped'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.stop_run",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#stop_run\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Write a file into a sandbox you hold
+    # Writes bytes to one path in the caller's sandbox, creating parents, and answers the resolved path.
+    # @param write_in [WriteIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Wrote]
+    def write_sandbox_file(write_in, opts = {})
+      data, _status_code, _headers = write_sandbox_file_with_http_info(write_in, opts)
+      data
+    end
+
+    # Write a file into a sandbox you hold
+    # Writes bytes to one path in the caller&#39;s sandbox, creating parents, and answers the resolved path.
+    # @param write_in [WriteIn] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Wrote, Integer, Hash)>] Wrote data, response status code and response headers
+    def write_sandbox_file_with_http_info(write_in, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SandboxApi.write_sandbox_file ...'
+      end
+      # verify the required parameter 'write_in' is set
+      if @api_client.config.client_side_validation && write_in.nil?
+        fail ArgumentError, "Missing the required parameter 'write_in' when calling SandboxApi.write_sandbox_file"
+      end
+      # resource path
+      local_var_path = '/v1/sandbox/write'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(write_in)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Wrote'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"SandboxApi.write_sandbox_file",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SandboxApi#write_sandbox_file\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end