hanzoai 8.5.156

data/lib/hanzoai/api/legal_api.rb

@@ -0,0 +1,727 @@
+=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 LegalApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Returns the org's generated documents, newest first, WITHOUT their rendered content — fetch one document to read its body.
+    # Returns the org's generated documents, newest first, WITHOUT their rendered content — fetch one document to read its body.  The response is marked no-store: these records name the counterparties an org is contracting with, and must not sit in a shared cache.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit bounds the page. Absent or unparseable means the store's own default.
+    # @return [DocumentPage]
+    def get_legal_documents(opts = {})
+      data, _status_code, _headers = get_legal_documents_with_http_info(opts)
+      data
+    end
+
+    # Returns the org's generated documents, newest first, WITHOUT their rendered content — fetch one document to read its body.
+    # Returns the org's generated documents, newest first, WITHOUT their rendered content — fetch one document to read its body.  The response is marked no-store: these records name the counterparties an org is contracting with, and must not sit in a shared cache.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit bounds the page. Absent or unparseable means the store's own default.
+    # @return [Array<(DocumentPage, Integer, Hash)>] DocumentPage data, response status code and response headers
+    def get_legal_documents_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegalApi.get_legal_documents ...'
+      end
+      # resource path
+      local_var_path = '/v1/legal/documents'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].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] || 'DocumentPage'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LegalApi.get_legal_documents",
+        :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: LegalApi#get_legal_documents\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one of the org's documents WITH its rendered body.
+    # Returns one of the org's documents WITH its rendered body. 404 when the org has no document with that id — a document is never readable across orgs.  The response is marked no-store: the body is contract text, sealed at rest and returned only to the owning org, and must not sit in a shared cache.
+    # @param id [String] ID is the document&#39;s server-minted handle, \&quot;doc_\&quot;-prefixed.
+    # @param [Hash] opts the optional parameters
+    # @return [DocumentReply]
+    def get_legal_documents_by_id(id, opts = {})
+      data, _status_code, _headers = get_legal_documents_by_id_with_http_info(id, opts)
+      data
+    end
+
+    # Returns one of the org&#39;s documents WITH its rendered body.
+    # Returns one of the org&#39;s documents WITH its rendered body. 404 when the org has no document with that id — a document is never readable across orgs.  The response is marked no-store: the body is contract text, sealed at rest and returned only to the owning org, and must not sit in a shared cache.
+    # @param id [String] ID is the document&#39;s server-minted handle, \&quot;doc_\&quot;-prefixed.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DocumentReply, Integer, Hash)>] DocumentReply data, response status code and response headers
+    def get_legal_documents_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegalApi.get_legal_documents_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 LegalApi.get_legal_documents_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/legal/documents/{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] || 'DocumentReply'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LegalApi.get_legal_documents_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: LegalApi#get_legal_documents_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's filing records, newest first — which documents were filed where, through which provider, and what the filing's honest status is.
+    # Returns the org's filing records, newest first — which documents were filed where, through which provider, and what the filing's honest status is.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit bounds the page. Absent or unparseable means the store&#39;s own default.
+    # @return [FilingPage]
+    def get_legal_filings(opts = {})
+      data, _status_code, _headers = get_legal_filings_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s filing records, newest first — which documents were filed where, through which provider, and what the filing&#39;s honest status is.
+    # Returns the org&#39;s filing records, newest first — which documents were filed where, through which provider, and what the filing&#39;s honest status is.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit bounds the page. Absent or unparseable means the store&#39;s own default.
+    # @return [Array<(FilingPage, Integer, Hash)>] FilingPage data, response status code and response headers
+    def get_legal_filings_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegalApi.get_legal_filings ...'
+      end
+      # resource path
+      local_var_path = '/v1/legal/filings'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].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] || 'FilingPage'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LegalApi.get_legal_filings",
+        :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: LegalApi#get_legal_filings\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Reports that the legal subsystem is serving and how many built-in templates its catalog carries.
+    # Reports that the legal subsystem is serving and how many built-in templates its catalog carries. It reads no tenant, so a liveness prober that sends no principal is answered rather than refused.
+    # @param [Hash] opts the optional parameters
+    # @return [LegalHealth]
+    def get_legal_health(opts = {})
+      data, _status_code, _headers = get_legal_health_with_http_info(opts)
+      data
+    end
+
+    # Reports that the legal subsystem is serving and how many built-in templates its catalog carries.
+    # Reports that the legal subsystem is serving and how many built-in templates its catalog carries. It reads no tenant, so a liveness prober that sends no principal is answered rather than refused.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(LegalHealth, Integer, Hash)>] LegalHealth data, response status code and response headers
+    def get_legal_health_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegalApi.get_legal_health ...'
+      end
+      # resource path
+      local_var_path = '/v1/legal/health'
+
+      # 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] || 'LegalHealth'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LegalApi.get_legal_health",
+        :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: LegalApi#get_legal_health\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's effective template catalog: every built-in template, with any the org has overridden replaced by its own latest version.
+    # Returns the org's effective template catalog: every built-in template, with any the org has overridden replaced by its own latest version.  The listing carries each template's metadata and its declared MERGE FIELDS — the keys a document generation must supply — but never the template bodies; fetch one template to get its body. Templates in the formation and equity categories are marked counselReview: every document rendered from them carries a counsel notice, and that posture cannot be dropped by an override.
+    # @param [Hash] opts the optional parameters
+    # @return [TemplateCatalog]
+    def get_legal_templates(opts = {})
+      data, _status_code, _headers = get_legal_templates_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s effective template catalog: every built-in template, with any the org has overridden replaced by its own latest version.
+    # Returns the org&#39;s effective template catalog: every built-in template, with any the org has overridden replaced by its own latest version.  The listing carries each template&#39;s metadata and its declared MERGE FIELDS — the keys a document generation must supply — but never the template bodies; fetch one template to get its body. Templates in the formation and equity categories are marked counselReview: every document rendered from them carries a counsel notice, and that posture cannot be dropped by an override.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TemplateCatalog, Integer, Hash)>] TemplateCatalog data, response status code and response headers
+    def get_legal_templates_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegalApi.get_legal_templates ...'
+      end
+      # resource path
+      local_var_path = '/v1/legal/templates'
+
+      # 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] || 'TemplateCatalog'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LegalApi.get_legal_templates",
+        :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: LegalApi#get_legal_templates\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one template resolved for the caller's org — the org's own override if it has saved one, else the built-in — with its full text/template body and its declared merge fields.
+    # Returns one template resolved for the caller's org — the org's own override if it has saved one, else the built-in — with its full text/template body and its declared merge fields. 404 when neither exists.
+    # @param id [String] ID is the template&#39;s stable id, e.g. \&quot;nda\&quot; or \&quot;safe\&quot;.
+    # @param [Hash] opts the optional parameters
+    # @return [TemplateReply]
+    def get_legal_templates_by_id(id, opts = {})
+      data, _status_code, _headers = get_legal_templates_by_id_with_http_info(id, opts)
+      data
+    end
+
+    # Returns one template resolved for the caller&#39;s org — the org&#39;s own override if it has saved one, else the built-in — with its full text/template body and its declared merge fields.
+    # Returns one template resolved for the caller&#39;s org — the org&#39;s own override if it has saved one, else the built-in — with its full text/template body and its declared merge fields. 404 when neither exists.
+    # @param id [String] ID is the template&#39;s stable id, e.g. \&quot;nda\&quot; or \&quot;safe\&quot;.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TemplateReply, Integer, Hash)>] TemplateReply data, response status code and response headers
+    def get_legal_templates_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegalApi.get_legal_templates_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 LegalApi.get_legal_templates_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/legal/templates/{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] || 'TemplateReply'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LegalApi.get_legal_templates_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: LegalApi#get_legal_templates_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Renders a document from a template and the caller's own merge data, seals it in the org's store, and returns it with its rendered body.
+    # Renders a document from a template and the caller's own merge data, seals it in the org's store, and returns it with its rendered body.  The render is PURE and deterministic — no clock, no I/O — so the same template version and the same data always produce identical bytes, which is what makes a generated contract reproducible. It fails CLOSED on a missing merge field: there is no blank-filled contract, only a 400 naming the fields that were absent. When the template is counsel-review the rendered body opens with the counsel notice, which no caller can suppress.  The document is a DRAFT. Hanzo Legal manages documents; it does not give legal advice and does not determine that a document is valid or sufficient.
+    # @param generate_request [GenerateRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [DocumentReply]
+    def post_legal_documents(generate_request, opts = {})
+      data, _status_code, _headers = post_legal_documents_with_http_info(generate_request, opts)
+      data
+    end
+
+    # Renders a document from a template and the caller&#39;s own merge data, seals it in the org&#39;s store, and returns it with its rendered body.
+    # Renders a document from a template and the caller&#39;s own merge data, seals it in the org&#39;s store, and returns it with its rendered body.  The render is PURE and deterministic — no clock, no I/O — so the same template version and the same data always produce identical bytes, which is what makes a generated contract reproducible. It fails CLOSED on a missing merge field: there is no blank-filled contract, only a 400 naming the fields that were absent. When the template is counsel-review the rendered body opens with the counsel notice, which no caller can suppress.  The document is a DRAFT. Hanzo Legal manages documents; it does not give legal advice and does not determine that a document is valid or sufficient.
+    # @param generate_request [GenerateRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DocumentReply, Integer, Hash)>] DocumentReply data, response status code and response headers
+    def post_legal_documents_with_http_info(generate_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegalApi.post_legal_documents ...'
+      end
+      # verify the required parameter 'generate_request' is set
+      if @api_client.config.client_side_validation && generate_request.nil?
+        fail ArgumentError, "Missing the required parameter 'generate_request' when calling LegalApi.post_legal_documents"
+      end
+      # resource path
+      local_var_path = '/v1/legal/documents'
+
+      # 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(generate_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DocumentReply'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LegalApi.post_legal_documents",
+        :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: LegalApi#post_legal_documents\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Opens an e-signature request over one document and moves it to out_for_signature, returning the provider's reference for the request.
+    # Opens an e-signature request over one document and moves it to out_for_signature, returning the provider's reference for the request.  The provider is whatever this deployment has wired. The honest default is \"manual\": the request is recorded and the org fulfils it out of band — nothing here fabricates a signature, and the stub never reports itself complete.
+    # @param id [String] ID is the document to send for signature, from the path.
+    # @param sign_request [SignRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [SignReply]
+    def post_legal_documents_by_id_sign(id, sign_request, opts = {})
+      data, _status_code, _headers = post_legal_documents_by_id_sign_with_http_info(id, sign_request, opts)
+      data
+    end
+
+    # Opens an e-signature request over one document and moves it to out_for_signature, returning the provider&#39;s reference for the request.
+    # Opens an e-signature request over one document and moves it to out_for_signature, returning the provider&#39;s reference for the request.  The provider is whatever this deployment has wired. The honest default is \&quot;manual\&quot;: the request is recorded and the org fulfils it out of band — nothing here fabricates a signature, and the stub never reports itself complete.
+    # @param id [String] ID is the document to send for signature, from the path.
+    # @param sign_request [SignRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SignReply, Integer, Hash)>] SignReply data, response status code and response headers
+    def post_legal_documents_by_id_sign_with_http_info(id, sign_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegalApi.post_legal_documents_by_id_sign ...'
+      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 LegalApi.post_legal_documents_by_id_sign"
+      end
+      # verify the required parameter 'sign_request' is set
+      if @api_client.config.client_side_validation && sign_request.nil?
+        fail ArgumentError, "Missing the required parameter 'sign_request' when calling LegalApi.post_legal_documents_by_id_sign"
+      end
+      # resource path
+      local_var_path = '/v1/legal/documents/{id}/sign'.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(sign_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SignReply'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LegalApi.post_legal_documents_by_id_sign",
+        :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: LegalApi#post_legal_documents_by_id_sign\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Record that a generated document's signature request completed
+    # Records completion of the signature request opened over a generated document and answers the document with a `signed` flag.  The e-sign provider's own status is consulted FIRST and is the default answer; an explicit `signed` field in the body overrides it. That override is the whole point: the default `manual` provider never self-completes, so a reviewer (or a real provider's webhook) is what moves the document. A completion flips the document to `signed`, stamps `signedAt`, and writes a `legal.document.signed` audit event; a provider still reporting incomplete answers 200 with the document unchanged, so the call is safe to repeat and never fabricates a signature.  Org-scoped and fails closed: a validated principal is required (403 without one), the document is read under the caller's OWN org so another tenant's id is a 404, a document with no open signature request is a 400, and a provider whose status call errors is a 502.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def post_legal_documents_by_id_sign_complete(id, opts = {})
+      post_legal_documents_by_id_sign_complete_with_http_info(id, opts)
+      nil
+    end
+
+    # Record that a generated document&#39;s signature request completed
+    # Records completion of the signature request opened over a generated document and answers the document with a &#x60;signed&#x60; flag.  The e-sign provider&#39;s own status is consulted FIRST and is the default answer; an explicit &#x60;signed&#x60; field in the body overrides it. That override is the whole point: the default &#x60;manual&#x60; provider never self-completes, so a reviewer (or a real provider&#39;s webhook) is what moves the document. A completion flips the document to &#x60;signed&#x60;, stamps &#x60;signedAt&#x60;, and writes a &#x60;legal.document.signed&#x60; audit event; a provider still reporting incomplete answers 200 with the document unchanged, so the call is safe to repeat and never fabricates a signature.  Org-scoped and fails closed: a validated principal is required (403 without one), the document is read under the caller&#39;s OWN org so another tenant&#39;s id is a 404, a document with no open signature request is a 400, and a provider whose status call errors is a 502.
+    # @param id [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_legal_documents_by_id_sign_complete_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegalApi.post_legal_documents_by_id_sign_complete ...'
+      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 LegalApi.post_legal_documents_by_id_sign_complete"
+      end
+      # resource path
+      local_var_path = '/v1/legal/documents/{id}/sign/complete'.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 => :"LegalApi.post_legal_documents_by_id_sign_complete",
+        :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: LegalApi#post_legal_documents_by_id_sign_complete\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Records a filing of one or more of the org's documents with a state or agency, and returns the tracking record.
+    # Records a filing of one or more of the org's documents with a state or agency, and returns the tracking record.  It is a TRACKING record, not an autonomous filing. With no filing partner wired the honest status is \"manual\" and the note says so: the documents were generated for signature, and the org files them through its registered agent. Nothing here invents a filing id it does not have.  Every document id must belong to the caller's org; one that does not is a 404 naming it, so a filing can never reach across tenants.
+    # @param filing_request [FilingRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [FilingReply]
+    def post_legal_filings(filing_request, opts = {})
+      data, _status_code, _headers = post_legal_filings_with_http_info(filing_request, opts)
+      data
+    end
+
+    # Records a filing of one or more of the org&#39;s documents with a state or agency, and returns the tracking record.
+    # Records a filing of one or more of the org&#39;s documents with a state or agency, and returns the tracking record.  It is a TRACKING record, not an autonomous filing. With no filing partner wired the honest status is \&quot;manual\&quot; and the note says so: the documents were generated for signature, and the org files them through its registered agent. Nothing here invents a filing id it does not have.  Every document id must belong to the caller&#39;s org; one that does not is a 404 naming it, so a filing can never reach across tenants.
+    # @param filing_request [FilingRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FilingReply, Integer, Hash)>] FilingReply data, response status code and response headers
+    def post_legal_filings_with_http_info(filing_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegalApi.post_legal_filings ...'
+      end
+      # verify the required parameter 'filing_request' is set
+      if @api_client.config.client_side_validation && filing_request.nil?
+        fail ArgumentError, "Missing the required parameter 'filing_request' when calling LegalApi.post_legal_filings"
+      end
+      # resource path
+      local_var_path = '/v1/legal/filings'
+
+      # 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(filing_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FilingReply'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LegalApi.post_legal_filings",
+        :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: LegalApi#post_legal_filings\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Saves the org's own version of a template — a custom NDA, a house MSA — and returns it with its new version number.
+    # Saves the org's own version of a template — a custom NDA, a house MSA — and returns it with its new version number. It takes effect for that org only; other orgs keep the built-in.  Two boundaries cannot be crossed here. Overriding a built-in INHERITS its category and its counsel-review posture, which can be raised but never dropped; and a formation or equity template is counsel-review whatever the caller sends, so no org can generate a securities-class document without the notice.  The body is validated on save, not at generation: a template that references an UNDECLARED merge field is refused with 400 rather than stored and rendered blank into a contract months later.
+    # @param id [String] ID is the template to override, from the path. Overriding a built-in id inherits that built-in&#39;s category, title and counsel-review posture.
+    # @param template_override [TemplateOverride] 
+    # @param [Hash] opts the optional parameters
+    # @return [TemplateReply]
+    def put_legal_templates_by_id(id, template_override, opts = {})
+      data, _status_code, _headers = put_legal_templates_by_id_with_http_info(id, template_override, opts)
+      data
+    end
+
+    # Saves the org&#39;s own version of a template — a custom NDA, a house MSA — and returns it with its new version number.
+    # Saves the org&#39;s own version of a template — a custom NDA, a house MSA — and returns it with its new version number. It takes effect for that org only; other orgs keep the built-in.  Two boundaries cannot be crossed here. Overriding a built-in INHERITS its category and its counsel-review posture, which can be raised but never dropped; and a formation or equity template is counsel-review whatever the caller sends, so no org can generate a securities-class document without the notice.  The body is validated on save, not at generation: a template that references an UNDECLARED merge field is refused with 400 rather than stored and rendered blank into a contract months later.
+    # @param id [String] ID is the template to override, from the path. Overriding a built-in id inherits that built-in&#39;s category, title and counsel-review posture.
+    # @param template_override [TemplateOverride] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TemplateReply, Integer, Hash)>] TemplateReply data, response status code and response headers
+    def put_legal_templates_by_id_with_http_info(id, template_override, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegalApi.put_legal_templates_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 LegalApi.put_legal_templates_by_id"
+      end
+      # verify the required parameter 'template_override' is set
+      if @api_client.config.client_side_validation && template_override.nil?
+        fail ArgumentError, "Missing the required parameter 'template_override' when calling LegalApi.put_legal_templates_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/legal/templates/{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']
+      # 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(template_override)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TemplateReply'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LegalApi.put_legal_templates_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(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LegalApi#put_legal_templates_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end