hanzoai 8.5.156

data/lib/hanzoai/api/compliance_api.rb

@@ -0,0 +1,1095 @@
+=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 ComplianceApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Returns the org's tracked accreditation-state records, newest first — evidence entries the org keeps, never a platform certification.
+    # Returns the org's tracked accreditation-state records, newest first — evidence entries the org keeps, never a platform certification.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps the rows returned; non-positive means the server default.
+    # @return [AccList]
+    def get_compliance_accreditation(opts = {})
+      data, _status_code, _headers = get_compliance_accreditation_with_http_info(opts)
+      data
+    end
+
+    # Returns the org's tracked accreditation-state records, newest first — evidence entries the org keeps, never a platform certification.
+    # Returns the org's tracked accreditation-state records, newest first — evidence entries the org keeps, never a platform certification.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps the rows returned; non-positive means the server default.
+    # @return [Array<(AccList, Integer, Hash)>] AccList data, response status code and response headers
+    def get_compliance_accreditation_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.get_compliance_accreditation ...'
+      end
+      # resource path
+      local_var_path = '/v1/compliance/accreditation'
+
+      # 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] || 'AccList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.get_compliance_accreditation",
+        :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: ComplianceApi#get_compliance_accreditation\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one tracked accreditation record.
+    # Returns one tracked accreditation record.
+    # @param id [String] ID is the accreditation record to read, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [AccView]
+    def get_compliance_accreditation_by_id(id, opts = {})
+      data, _status_code, _headers = get_compliance_accreditation_by_id_with_http_info(id, opts)
+      data
+    end
+
+    # Returns one tracked accreditation record.
+    # Returns one tracked accreditation record.
+    # @param id [String] ID is the accreditation record to read, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AccView, Integer, Hash)>] AccView data, response status code and response headers
+    def get_compliance_accreditation_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.get_compliance_accreditation_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 ComplianceApi.get_compliance_accreditation_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/compliance/accreditation/{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] || 'AccView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.get_compliance_accreditation_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: ComplianceApi#get_compliance_accreditation_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # AuditRead is the compliance read of the SHARED tamper-evident audit plane — the SOC 2 posture surface (privileged actions: who started/decided what, when).
+    # AuditRead is the compliance read of the SHARED tamper-evident audit plane — the SOC 2 posture surface (privileged actions: who started/decided what, when). The org is PINNED to the caller's validated org and the rows are narrowed to compliance.* actions. Fail-closed: no principal is a 403, no configured audit store a 501.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :result Result filters rows by outcome result: success, deny, or error; empty means all.
+    # @return [AuditList]
+    def get_compliance_audit(opts = {})
+      data, _status_code, _headers = get_compliance_audit_with_http_info(opts)
+      data
+    end
+
+    # AuditRead is the compliance read of the SHARED tamper-evident audit plane — the SOC 2 posture surface (privileged actions: who started/decided what, when).
+    # AuditRead is the compliance read of the SHARED tamper-evident audit plane — the SOC 2 posture surface (privileged actions: who started/decided what, when). The org is PINNED to the caller&#39;s validated org and the rows are narrowed to compliance.* actions. Fail-closed: no principal is a 403, no configured audit store a 501.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :result Result filters rows by outcome result: success, deny, or error; empty means all.
+    # @return [Array<(AuditList, Integer, Hash)>] AuditList data, response status code and response headers
+    def get_compliance_audit_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.get_compliance_audit ...'
+      end
+      # resource path
+      local_var_path = '/v1/compliance/audit'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'result'] = opts[:'result'] if !opts[:'result'].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] || 'AuditList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.get_compliance_audit",
+        :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: ComplianceApi#get_compliance_audit\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Health reports subsystem liveness and the wired verification provider.
+    # Health reports subsystem liveness and the wired verification provider. Fail-open on purpose: it never probes the external provider, so a provider outage cannot fail liveness.
+    # @param [Hash] opts the optional parameters
+    # @return [HealthView]
+    def get_compliance_health(opts = {})
+      data, _status_code, _headers = get_compliance_health_with_http_info(opts)
+      data
+    end
+
+    # Health reports subsystem liveness and the wired verification provider.
+    # Health reports subsystem liveness and the wired verification provider. Fail-open on purpose: it never probes the external provider, so a provider outage cannot fail liveness.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(HealthView, Integer, Hash)>] HealthView data, response status code and response headers
+    def get_compliance_health_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.get_compliance_health ...'
+      end
+      # resource path
+      local_var_path = '/v1/compliance/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] || 'HealthView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.get_compliance_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: ComplianceApi#get_compliance_health\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # ListRecords is the unified compliance-record view for the org: its verifications and accreditation records together, each provider-reported or tracked, never platform-asserted.
+    # ListRecords is the unified compliance-record view for the org: its verifications and accreditation records together, each provider-reported or tracked, never platform-asserted. PII stays in the subject store; records carry only opaque ids and statuses.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps the rows returned; non-positive means the server default.
+    # @return [RecordList]
+    def get_compliance_records(opts = {})
+      data, _status_code, _headers = get_compliance_records_with_http_info(opts)
+      data
+    end
+
+    # ListRecords is the unified compliance-record view for the org: its verifications and accreditation records together, each provider-reported or tracked, never platform-asserted.
+    # ListRecords is the unified compliance-record view for the org: its verifications and accreditation records together, each provider-reported or tracked, never platform-asserted. PII stays in the subject store; records carry only opaque ids and statuses.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps the rows returned; non-positive means the server default.
+    # @return [Array<(RecordList, Integer, Hash)>] RecordList data, response status code and response headers
+    def get_compliance_records_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.get_compliance_records ...'
+      end
+      # resource path
+      local_var_path = '/v1/compliance/records'
+
+      # 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] || 'RecordList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.get_compliance_records",
+        :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: ComplianceApi#get_compliance_records\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Status is the org's honest posture read: the wired provider and the per-status tally of its verifications.
+    # Status is the org's honest posture read: the wired provider and the per-status tally of its verifications. It is deliberately NOT a boolean \"compliant\" — it reports counts of provider-reported states and carries the boundary disclaimer.
+    # @param [Hash] opts the optional parameters
+    # @return [StatusView]
+    def get_compliance_status(opts = {})
+      data, _status_code, _headers = get_compliance_status_with_http_info(opts)
+      data
+    end
+
+    # Status is the org&#39;s honest posture read: the wired provider and the per-status tally of its verifications.
+    # Status is the org&#39;s honest posture read: the wired provider and the per-status tally of its verifications. It is deliberately NOT a boolean \&quot;compliant\&quot; — it reports counts of provider-reported states and carries the boundary disclaimer.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(StatusView, Integer, Hash)>] StatusView data, response status code and response headers
+    def get_compliance_status_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.get_compliance_status ...'
+      end
+      # resource path
+      local_var_path = '/v1/compliance/status'
+
+      # 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] || 'StatusView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.get_compliance_status",
+        :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: ComplianceApi#get_compliance_status\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's subjects as PII-MINIMIZED summaries — no name or email, only whether an email is on file.
+    # Returns the org's subjects as PII-MINIMIZED summaries — no name or email, only whether an email is on file. The full record is returned only by the explicit single-subject read.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps the rows returned; non-positive means the server default.
+    # @return [SubjectList]
+    def get_compliance_subjects(opts = {})
+      data, _status_code, _headers = get_compliance_subjects_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s subjects as PII-MINIMIZED summaries — no name or email, only whether an email is on file.
+    # Returns the org&#39;s subjects as PII-MINIMIZED summaries — no name or email, only whether an email is on file. The full record is returned only by the explicit single-subject read.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps the rows returned; non-positive means the server default.
+    # @return [Array<(SubjectList, Integer, Hash)>] SubjectList data, response status code and response headers
+    def get_compliance_subjects_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.get_compliance_subjects ...'
+      end
+      # resource path
+      local_var_path = '/v1/compliance/subjects'
+
+      # 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] || 'SubjectList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.get_compliance_subjects",
+        :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: ComplianceApi#get_compliance_subjects\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one subject WITH its contact PII — the only surface that returns it, and only to the owning org.
+    # Returns one subject WITH its contact PII — the only surface that returns it, and only to the owning org. The response is never cached by any intermediary.
+    # @param id [String] ID is the subject to read, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Subject]
+    def get_compliance_subjects_by_id(id, opts = {})
+      data, _status_code, _headers = get_compliance_subjects_by_id_with_http_info(id, opts)
+      data
+    end
+
+    # Returns one subject WITH its contact PII — the only surface that returns it, and only to the owning org.
+    # Returns one subject WITH its contact PII — the only surface that returns it, and only to the owning org. The response is never cached by any intermediary.
+    # @param id [String] ID is the subject to read, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Subject, Integer, Hash)>] Subject data, response status code and response headers
+    def get_compliance_subjects_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.get_compliance_subjects_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 ComplianceApi.get_compliance_subjects_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/compliance/subjects/{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] || 'Subject'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.get_compliance_subjects_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: ComplianceApi#get_compliance_subjects_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the org's KYC/KYB verifications, newest first — opaque subject references and provider-reported statuses only, no subject PII.
+    # Returns the org's KYC/KYB verifications, newest first — opaque subject references and provider-reported statuses only, no subject PII.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps the rows returned; non-positive means the server default.
+    # @return [CheckList]
+    def get_compliance_verifications(opts = {})
+      data, _status_code, _headers = get_compliance_verifications_with_http_info(opts)
+      data
+    end
+
+    # Returns the org&#39;s KYC/KYB verifications, newest first — opaque subject references and provider-reported statuses only, no subject PII.
+    # Returns the org&#39;s KYC/KYB verifications, newest first — opaque subject references and provider-reported statuses only, no subject PII.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Limit caps the rows returned; non-positive means the server default.
+    # @return [Array<(CheckList, Integer, Hash)>] CheckList data, response status code and response headers
+    def get_compliance_verifications_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.get_compliance_verifications ...'
+      end
+      # resource path
+      local_var_path = '/v1/compliance/verifications'
+
+      # 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] || 'CheckList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.get_compliance_verifications",
+        :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: ComplianceApi#get_compliance_verifications\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one verification — its opaque subject reference and provider-reported status, no subject PII.
+    # Returns one verification — its opaque subject reference and provider-reported status, no subject PII.
+    # @param id [String] ID is the verification to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [CheckView]
+    def get_compliance_verifications_by_id(id, opts = {})
+      data, _status_code, _headers = get_compliance_verifications_by_id_with_http_info(id, opts)
+      data
+    end
+
+    # Returns one verification — its opaque subject reference and provider-reported status, no subject PII.
+    # Returns one verification — its opaque subject reference and provider-reported status, no subject PII.
+    # @param id [String] ID is the verification to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CheckView, Integer, Hash)>] CheckView data, response status code and response headers
+    def get_compliance_verifications_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.get_compliance_verifications_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 ComplianceApi.get_compliance_verifications_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/compliance/verifications/{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] || 'CheckView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.get_compliance_verifications_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: ComplianceApi#get_compliance_verifications_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Records an ASSERTED accreditation state for a subject — the subject's own assertion, with no verifier.
+    # Records an ASSERTED accreditation state for a subject — the subject's own assertion, with no verifier. Every CONFIRMED state (provider_verified, reviewer_confirmed) and every rejected/expired state is a DECISION recorded via the decision endpoint, attributed to the reviewer — a create can never stamp a confirmation. The underlying figures (income, net worth) are never stored; only the method, category, and state.
+    # @param accreditation_req [AccreditationReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [AccView]
+    def post_compliance_accreditation(accreditation_req, opts = {})
+      data, _status_code, _headers = post_compliance_accreditation_with_http_info(accreditation_req, opts)
+      data
+    end
+
+    # Records an ASSERTED accreditation state for a subject — the subject&#39;s own assertion, with no verifier.
+    # Records an ASSERTED accreditation state for a subject — the subject&#39;s own assertion, with no verifier. Every CONFIRMED state (provider_verified, reviewer_confirmed) and every rejected/expired state is a DECISION recorded via the decision endpoint, attributed to the reviewer — a create can never stamp a confirmation. The underlying figures (income, net worth) are never stored; only the method, category, and state.
+    # @param accreditation_req [AccreditationReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AccView, Integer, Hash)>] AccView data, response status code and response headers
+    def post_compliance_accreditation_with_http_info(accreditation_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.post_compliance_accreditation ...'
+      end
+      # verify the required parameter 'accreditation_req' is set
+      if @api_client.config.client_side_validation && accreditation_req.nil?
+        fail ArgumentError, "Missing the required parameter 'accreditation_req' when calling ComplianceApi.post_compliance_accreditation"
+      end
+      # resource path
+      local_var_path = '/v1/compliance/accreditation'
+
+      # 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(accreditation_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AccView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.post_compliance_accreditation",
+        :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: ComplianceApi#post_compliance_accreditation\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Records an org reviewer's decision on an accreditation record — a reviewer confirmation, a provider verification the reviewer has evidence of (a CPA/attorney letter, a verifier report), a rejection, or an expiry.
+    # Records an org reviewer's decision on an accreditation record — a reviewer confirmation, a provider verification the reviewer has evidence of (a CPA/attorney letter, a verifier report), a rejection, or an expiry. ROLE-GATED (an org admin or platform reviewer) and ATTRIBUTED: the reviewer's identity is recorded as ReviewerSub and audited. Human-in-the-loop: the platform never confirms on its own, and even a provider_verified state carries the reviewer who recorded it.
+    # @param id [String] ID is the accreditation record to decide, from the path.
+    # @param accreditation_decision [AccreditationDecision] 
+    # @param [Hash] opts the optional parameters
+    # @return [AccView]
+    def post_compliance_accreditation_by_id_decision(id, accreditation_decision, opts = {})
+      data, _status_code, _headers = post_compliance_accreditation_by_id_decision_with_http_info(id, accreditation_decision, opts)
+      data
+    end
+
+    # Records an org reviewer&#39;s decision on an accreditation record — a reviewer confirmation, a provider verification the reviewer has evidence of (a CPA/attorney letter, a verifier report), a rejection, or an expiry.
+    # Records an org reviewer&#39;s decision on an accreditation record — a reviewer confirmation, a provider verification the reviewer has evidence of (a CPA/attorney letter, a verifier report), a rejection, or an expiry. ROLE-GATED (an org admin or platform reviewer) and ATTRIBUTED: the reviewer&#39;s identity is recorded as ReviewerSub and audited. Human-in-the-loop: the platform never confirms on its own, and even a provider_verified state carries the reviewer who recorded it.
+    # @param id [String] ID is the accreditation record to decide, from the path.
+    # @param accreditation_decision [AccreditationDecision] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AccView, Integer, Hash)>] AccView data, response status code and response headers
+    def post_compliance_accreditation_by_id_decision_with_http_info(id, accreditation_decision, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.post_compliance_accreditation_by_id_decision ...'
+      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 ComplianceApi.post_compliance_accreditation_by_id_decision"
+      end
+      # verify the required parameter 'accreditation_decision' is set
+      if @api_client.config.client_side_validation && accreditation_decision.nil?
+        fail ArgumentError, "Missing the required parameter 'accreditation_decision' when calling ComplianceApi.post_compliance_accreditation_by_id_decision"
+      end
+      # resource path
+      local_var_path = '/v1/compliance/accreditation/{id}/decision'.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(accreditation_decision)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AccView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.post_compliance_accreditation_by_id_decision",
+        :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: ComplianceApi#post_compliance_accreditation_by_id_decision\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Records a party the org is verifying as part of its own onboarding/compliance — a team member, vendor, customer, or counterparty.
+    # Records a party the org is verifying as part of its own onboarding/compliance — a team member, vendor, customer, or counterparty. The subject's contact PII (name/email) is sealed at rest and returned only to the owning org; downstream records reference the subject by opaque id.
+    # @param subject_req [SubjectReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Subject]
+    def post_compliance_subjects(subject_req, opts = {})
+      data, _status_code, _headers = post_compliance_subjects_with_http_info(subject_req, opts)
+      data
+    end
+
+    # Records a party the org is verifying as part of its own onboarding/compliance — a team member, vendor, customer, or counterparty.
+    # Records a party the org is verifying as part of its own onboarding/compliance — a team member, vendor, customer, or counterparty. The subject&#39;s contact PII (name/email) is sealed at rest and returned only to the owning org; downstream records reference the subject by opaque id.
+    # @param subject_req [SubjectReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Subject, Integer, Hash)>] Subject data, response status code and response headers
+    def post_compliance_subjects_with_http_info(subject_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.post_compliance_subjects ...'
+      end
+      # verify the required parameter 'subject_req' is set
+      if @api_client.config.client_side_validation && subject_req.nil?
+        fail ArgumentError, "Missing the required parameter 'subject_req' when calling ComplianceApi.post_compliance_subjects"
+      end
+      # resource path
+      local_var_path = '/v1/compliance/subjects'
+
+      # 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(subject_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Subject'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.post_compliance_subjects",
+        :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: ComplianceApi#post_compliance_subjects\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Begins a KYC/KYB verification of a subject through the wired provider — an existing subject by id, or one created inline from the request.
+    # Begins a KYC/KYB verification of a subject through the wired provider — an existing subject by id, or one created inline from the request. The returned status is provider-reported and never terminal on a fresh start: starting a verification can never yield a verified record, and a provider error is a 502, never a verification.
+    # @param verification_req [VerificationReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [CheckView]
+    def post_compliance_verifications(verification_req, opts = {})
+      data, _status_code, _headers = post_compliance_verifications_with_http_info(verification_req, opts)
+      data
+    end
+
+    # Begins a KYC/KYB verification of a subject through the wired provider — an existing subject by id, or one created inline from the request.
+    # Begins a KYC/KYB verification of a subject through the wired provider — an existing subject by id, or one created inline from the request. The returned status is provider-reported and never terminal on a fresh start: starting a verification can never yield a verified record, and a provider error is a 502, never a verification.
+    # @param verification_req [VerificationReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CheckView, Integer, Hash)>] CheckView data, response status code and response headers
+    def post_compliance_verifications_with_http_info(verification_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.post_compliance_verifications ...'
+      end
+      # verify the required parameter 'verification_req' is set
+      if @api_client.config.client_side_validation && verification_req.nil?
+        fail ArgumentError, "Missing the required parameter 'verification_req' when calling ComplianceApi.post_compliance_verifications"
+      end
+      # resource path
+      local_var_path = '/v1/compliance/verifications'
+
+      # 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(verification_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CheckView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.post_compliance_verifications",
+        :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: ComplianceApi#post_compliance_verifications\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Records a privileged reviewer's MANUAL decision on a verification — the human-in-the-loop path, and the ONLY route to a passing status when no real provider is wired.
+    # Records a privileged reviewer's MANUAL decision on a verification — the human-in-the-loop path, and the ONLY route to a passing status when no real provider is wired. It produces a DISTINCT reviewer_confirmed, never a provider_verified (a provider decision is the provider's to report, via the webhook or a reconcile), and it is ROLE-GATED (an org admin or platform reviewer) AND ATTRIBUTED (the reviewer's user id is DecidedBy), so a manual pass is always accountable.
+    # @param id [String] ID is the verification to decide, from the path.
+    # @param verification_decision [VerificationDecision] 
+    # @param [Hash] opts the optional parameters
+    # @return [CheckView]
+    def post_compliance_verifications_by_id_decision(id, verification_decision, opts = {})
+      data, _status_code, _headers = post_compliance_verifications_by_id_decision_with_http_info(id, verification_decision, opts)
+      data
+    end
+
+    # Records a privileged reviewer&#39;s MANUAL decision on a verification — the human-in-the-loop path, and the ONLY route to a passing status when no real provider is wired.
+    # Records a privileged reviewer&#39;s MANUAL decision on a verification — the human-in-the-loop path, and the ONLY route to a passing status when no real provider is wired. It produces a DISTINCT reviewer_confirmed, never a provider_verified (a provider decision is the provider&#39;s to report, via the webhook or a reconcile), and it is ROLE-GATED (an org admin or platform reviewer) AND ATTRIBUTED (the reviewer&#39;s user id is DecidedBy), so a manual pass is always accountable.
+    # @param id [String] ID is the verification to decide, from the path.
+    # @param verification_decision [VerificationDecision] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CheckView, Integer, Hash)>] CheckView data, response status code and response headers
+    def post_compliance_verifications_by_id_decision_with_http_info(id, verification_decision, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.post_compliance_verifications_by_id_decision ...'
+      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 ComplianceApi.post_compliance_verifications_by_id_decision"
+      end
+      # verify the required parameter 'verification_decision' is set
+      if @api_client.config.client_side_validation && verification_decision.nil?
+        fail ArgumentError, "Missing the required parameter 'verification_decision' when calling ComplianceApi.post_compliance_verifications_by_id_decision"
+      end
+      # resource path
+      local_var_path = '/v1/compliance/verifications/{id}/decision'.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(verification_decision)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CheckView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.post_compliance_verifications_by_id_decision",
+        :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: ComplianceApi#post_compliance_verifications_by_id_decision\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Polls the wired provider for its current decision and records it, ATTRIBUTED to the provider — the internal PULL reconcile.
+    # Polls the wired provider for its current decision and records it, ATTRIBUTED to the provider — the internal PULL reconcile. For the Manual provider the check stays pending; for a hosted provider it reflects the provider's settled status. A poll error is a 502, never a verification.
+    # @param id [String] ID is the verification to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [CheckView]
+    def post_compliance_verifications_by_id_refresh(id, opts = {})
+      data, _status_code, _headers = post_compliance_verifications_by_id_refresh_with_http_info(id, opts)
+      data
+    end
+
+    # Polls the wired provider for its current decision and records it, ATTRIBUTED to the provider — the internal PULL reconcile.
+    # Polls the wired provider for its current decision and records it, ATTRIBUTED to the provider — the internal PULL reconcile. For the Manual provider the check stays pending; for a hosted provider it reflects the provider&#39;s settled status. A poll error is a 502, never a verification.
+    # @param id [String] ID is the verification to act on, from the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CheckView, Integer, Hash)>] CheckView data, response status code and response headers
+    def post_compliance_verifications_by_id_refresh_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.post_compliance_verifications_by_id_refresh ...'
+      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 ComplianceApi.post_compliance_verifications_by_id_refresh"
+      end
+      # resource path
+      local_var_path = '/v1/compliance/verifications/{id}/refresh'.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] || 'CheckView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"ComplianceApi.post_compliance_verifications_by_id_refresh",
+        :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: ComplianceApi#post_compliance_verifications_by_id_refresh\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Provider push that settles a verification, authenticated by HMAC signature
+    # The external PUSH reconcile: a verification provider (or a Hanzo relay) signals that a check settled, and the reconciled check comes back. It authenticates by an HMAC SIGNATURE over the RAW body bytes rather than by a principal — an external caller has no validated org — and the org is then resolved FROM the record the signed provider reference matches, so a call can only ever touch the one tenant that owns that reference.  The body carries NO trusted decision. A valid signature cannot force a status: the reference only says WHICH check to re-read, and the status is then pulled from the wired provider, which stays the source of truth. With no real provider configured a check stays pending, and the only route to a passing status is the role-gated, attributed reviewer decision.  An unknown reference is a benign 200 `{\"ignored\": ...}` no-op, not an error, so a provider replaying stale events neither retry-storms nor learns whether a reference exists in some other tenant. Fails closed otherwise: 501 unless a webhook secret is configured, 401 on a signature that does not verify, 400 with no provider reference, 413 over 1 MiB, and 502 if the secret or the provider is unreachable.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def post_compliance_verifications_webhook(opts = {})
+      post_compliance_verifications_webhook_with_http_info(opts)
+      nil
+    end
+
+    # Provider push that settles a verification, authenticated by HMAC signature
+    # The external PUSH reconcile: a verification provider (or a Hanzo relay) signals that a check settled, and the reconciled check comes back. It authenticates by an HMAC SIGNATURE over the RAW body bytes rather than by a principal — an external caller has no validated org — and the org is then resolved FROM the record the signed provider reference matches, so a call can only ever touch the one tenant that owns that reference.  The body carries NO trusted decision. A valid signature cannot force a status: the reference only says WHICH check to re-read, and the status is then pulled from the wired provider, which stays the source of truth. With no real provider configured a check stays pending, and the only route to a passing status is the role-gated, attributed reviewer decision.  An unknown reference is a benign 200 &#x60;{\&quot;ignored\&quot;: ...}&#x60; no-op, not an error, so a provider replaying stale events neither retry-storms nor learns whether a reference exists in some other tenant. Fails closed otherwise: 501 unless a webhook secret is configured, 401 on a signature that does not verify, 400 with no provider reference, 413 over 1 MiB, and 502 if the secret or the provider is unreachable.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_compliance_verifications_webhook_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ComplianceApi.post_compliance_verifications_webhook ...'
+      end
+      # resource path
+      local_var_path = '/v1/compliance/verifications/webhook'
+
+      # 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 => :"ComplianceApi.post_compliance_verifications_webhook",
+        :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: ComplianceApi#post_compliance_verifications_webhook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end