spartera_api_sdk 1.0.82 → 1.0.83

data/docs/EndpointsApi.md

@@ -6,6 +6,7 @@ All URIs are relative to *https://api.spartera.com*
 | ------ | ------------ | ----------- |
 | [**create_endpoints**](EndpointsApi.md#create_endpoints) | **POST** /companies/{company_id}/endpoints | Create a new endpoint |
 | [**create_endpoints_keys**](EndpointsApi.md#create_endpoints_keys) | **POST** /companies/{company_id}/endpoints/{endpoint_id}/keys | POST /companies/{company_id}/endpoints/{endpoint_id}/keys |
+| [**create_endpoints_scan_column**](EndpointsApi.md#create_endpoints_scan_column) | **POST** /companies/{company_id}/endpoints/{endpoint_id}/scan_column | POST /companies/{company_id}/endpoints/{endpoint_id}/scan_column |
 | [**delete_endpoints**](EndpointsApi.md#delete_endpoints) | **DELETE** /companies/{company_id}/endpoints/{endpoint_id} | Delete single endpoint by ID |
 | [**delete_endpoints_keys**](EndpointsApi.md#delete_endpoints_keys) | **DELETE** /companies/{company_id}/endpoints/{endpoint_id}/keys/{api_key_id} | DELETE /companies/{company_id}/endpoints/{endpoint_id}/keys/{api_key_id} |
 | [**get_endpoints_by_id**](EndpointsApi.md#get_endpoints_by_id) | **GET** /companies/{company_id}/endpoints/{endpoint_id} | Get single endpoint by ID |
@@ -13,6 +14,7 @@ All URIs are relative to *https://api.spartera.com*
 | [**get_endpoints_by_id_connections_describe**](EndpointsApi.md#get_endpoints_by_id_connections_describe) | **GET** /companies/{company_id}/endpoints/../connections/{connection_id}/describe | Get schema information for a connection      Query parameters:         include_fields: Whether to include field information (default: true)         schemas: Optional comma-separated schemas to include         tables: Optional comma-separated tables to include |
 | [**get_endpoints_by_id_execute**](EndpointsApi.md#get_endpoints_by_id_execute) | **GET** /companies/{company_id}/endpoints/{endpoint_id}/execute | Execute an endpoint with pagination support.      Customer-facing route that returns paginated data.     Query params: ?start=0&limit=100 |
 | [**get_endpoints_by_id_keys**](EndpointsApi.md#get_endpoints_by_id_keys) | **GET** /companies/{company_id}/endpoints/{endpoint_id}/keys | GET /companies/{company_id}/endpoints/{endpoint_id}/keys |
+| [**get_endpoints_by_id_recommendations**](EndpointsApi.md#get_endpoints_by_id_recommendations) | **GET** /companies/{company_id}/endpoints/{endpoint_id}/recommendations | GET /companies/{company_id}/endpoints/{endpoint_id}/recommendations |
 | [**get_endpoints_by_id_stats**](EndpointsApi.md#get_endpoints_by_id_stats) | **GET** /companies/{company_id}/endpoints/{endpoint_id}/stats | Get usage statistics for an endpoint      Query parameters:         days: Number of days to analyze (default: 30) |
 | [**get_endpoints_by_id_test**](EndpointsApi.md#get_endpoints_by_id_test) | **GET** /companies/{company_id}/endpoints/{endpoint_id}/test | Test an endpoint with sample data      Request body (optional):         limit: Number of sample rows to return (default: 10) |
 | [**get_endpoints_by_id_url**](EndpointsApi.md#get_endpoints_by_id_url) | **GET** /companies/{company_id}/endpoints/{endpoint_id}/url | GET /companies/{company_id}/endpoints/{endpoint_id}/url |
@@ -176,6 +178,79 @@ end
 - **Accept**: application/json
 
 
+## create_endpoints_scan_column
+
+> <CreateEndpoints200Response> create_endpoints_scan_column(company_id, endpoint_id, endpoints_input)
+
+POST /companies/{company_id}/endpoints/{endpoint_id}/scan_column
+
+### Examples
+
+```ruby
+require 'time'
+require 'spartera_api_sdk'
+# setup authorization
+SparteraApiSdk.configure do |config|
+  # Configure API key authorization: ApiKeyAuth
+  config.api_key['x-api-key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['x-api-key'] = 'Bearer'
+end
+
+api_instance = SparteraApiSdk::EndpointsApi.new
+company_id = 'company_id_example' # String | Unique identifier for the Company
+endpoint_id = 'endpoint_id_example' # String | Unique identifier for the Endpoint
+endpoints_input = SparteraApiSdk::EndpointsInput.new({company_id: 'company_id_abc123', connection_id: 'connection_id_abc123', name: 'Example Name'}) # EndpointsInput | 
+
+begin
+  # POST /companies/{company_id}/endpoints/{endpoint_id}/scan_column
+  result = api_instance.create_endpoints_scan_column(company_id, endpoint_id, endpoints_input)
+  p result
+rescue SparteraApiSdk::ApiError => e
+  puts "Error when calling EndpointsApi->create_endpoints_scan_column: #{e}"
+end
+```
+
+#### Using the create_endpoints_scan_column_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CreateEndpoints200Response>, Integer, Hash)> create_endpoints_scan_column_with_http_info(company_id, endpoint_id, endpoints_input)
+
+```ruby
+begin
+  # POST /companies/{company_id}/endpoints/{endpoint_id}/scan_column
+  data, status_code, headers = api_instance.create_endpoints_scan_column_with_http_info(company_id, endpoint_id, endpoints_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CreateEndpoints200Response>
+rescue SparteraApiSdk::ApiError => e
+  puts "Error when calling EndpointsApi->create_endpoints_scan_column_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **company_id** | **String** | Unique identifier for the Company |  |
+| **endpoint_id** | **String** | Unique identifier for the Endpoint |  |
+| **endpoints_input** | [**EndpointsInput**](EndpointsInput.md) |  |  |
+
+### Return type
+
+[**CreateEndpoints200Response**](CreateEndpoints200Response.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## delete_endpoints
 
 > <DeleteEndpoints200Response> delete_endpoints(company_id, endpoint_id)
@@ -675,6 +750,77 @@ end
 - **Accept**: application/json
 
 
+## get_endpoints_by_id_recommendations
+
+> <GetEndpointsByIdConnectionsDescribe200Response> get_endpoints_by_id_recommendations(company_id, endpoint_id)
+
+GET /companies/{company_id}/endpoints/{endpoint_id}/recommendations
+
+### Examples
+
+```ruby
+require 'time'
+require 'spartera_api_sdk'
+# setup authorization
+SparteraApiSdk.configure do |config|
+  # Configure API key authorization: ApiKeyAuth
+  config.api_key['x-api-key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['x-api-key'] = 'Bearer'
+end
+
+api_instance = SparteraApiSdk::EndpointsApi.new
+company_id = 'company_id_example' # String | Unique identifier for the Company
+endpoint_id = 'endpoint_id_example' # String | Unique identifier for the Endpoint
+
+begin
+  # GET /companies/{company_id}/endpoints/{endpoint_id}/recommendations
+  result = api_instance.get_endpoints_by_id_recommendations(company_id, endpoint_id)
+  p result
+rescue SparteraApiSdk::ApiError => e
+  puts "Error when calling EndpointsApi->get_endpoints_by_id_recommendations: #{e}"
+end
+```
+
+#### Using the get_endpoints_by_id_recommendations_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetEndpointsByIdConnectionsDescribe200Response>, Integer, Hash)> get_endpoints_by_id_recommendations_with_http_info(company_id, endpoint_id)
+
+```ruby
+begin
+  # GET /companies/{company_id}/endpoints/{endpoint_id}/recommendations
+  data, status_code, headers = api_instance.get_endpoints_by_id_recommendations_with_http_info(company_id, endpoint_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetEndpointsByIdConnectionsDescribe200Response>
+rescue SparteraApiSdk::ApiError => e
+  puts "Error when calling EndpointsApi->get_endpoints_by_id_recommendations_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **company_id** | **String** | Unique identifier for the Company |  |
+| **endpoint_id** | **String** | Unique identifier for the Endpoint |  |
+
+### Return type
+
+[**GetEndpointsByIdConnectionsDescribe200Response**](GetEndpointsByIdConnectionsDescribe200Response.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_endpoints_by_id_stats
 
 > <GetEndpointsByIdConnectionsDescribe200Response> get_endpoints_by_id_stats(company_id, endpoint_id)

data/docs/EndpointsInput.md

@@ -15,24 +15,32 @@
 | **approved_by_user_id** | **String** | User who approved this endpoint for marketplace | [optional] |
 | **approved_at** | **Time** | Timestamp of marketplace approval | [optional] |
 | **sell_in_marketplace** | **Boolean** | Whether this endpoint appears in the public marketplace | [optional] |
-| **price_credits** | **Integer** | Credits deducted from the buyer's pool per successful (200 OK) request. Same credit pool as assets. price_usd kept for billing records / dashboards. | [optional] |
 | **name** | **String** | Human-readable name for the endpoint |  |
 | **slug** | **String** | Human-readable, URL-safe slug derived from name at creation time. e.g. 'NFL Live Moneyline & Spread Odds' → 'nfl-live-moneyline-spread-odds'. Never changes after creation. Unique within company (DB constraint). Creation fails with 409 if a duplicate name exists in the same company. | [optional] |
 | **description** | **String** | Description of what this endpoint provides | [optional] |
+| **detailed_description** | **String** | Long-form HTML description for product pages and SEO | [optional] |
+| **top_questions** | **String** | Top 3 questions this endpoint can help answer, in English. Stored as JSON array of strings (1-3 items, 15-200 chars each). Strongly encouraged for marketplace endpoints but not required — nudge via UI completeness score, not hard validation. | [optional] |
 | **source_schema_name** | **String** | Schema/database name where the table resides | [optional] |
 | **source_table_name** | **String** | Table name to query from | [optional] |
-| **customer_name** | **String** | Named customer for B2B deals (marketplace uses price_credits instead) | [optional] |
-| **price_usd** | **Float** | USD reference price for billing records and seller dashboards | [optional] |
+| **customer_name** | **String** | Named customer for B2B deals (pricing handled via asset_price_history) | [optional] |
 | **endpoint_schema** | **Object** | Column configurations including aggregations, filters, and visibility. Format: {columns: [{name, type, aggregation, filter, is_hidden, alias, ...}]}. This is the source of truth — SQL is generated at runtime from this configuration. | [optional] |
-| **rate_limit_requests** | **Integer** | Number of requests allowed per rate_limit_period | [optional] |
+| **rate_limit_number** | **Integer** | Number of requests allowed per rate_limit_period | [optional] |
 | **rate_limit_period** | **String** | Time period for rate limiting (HOUR, DAY, MONTH) | [optional] |
 | **rate_limit_granularity** | **String** | How to group rate limits (IP, USER, COMPANY, API_KEY, GLOBAL) | [optional] |
 | **access_method** | **String** | Access control method (OPEN, API_KEY, IP, EMAIL, DOMAIN) | [optional] |
 | **access_whitelist** | **Object** | List of allowed IPs, emails, or domains based on access_method. Format: {type: 'ip'|'email'|'domain', values: ['192.168.1.1', ...]} | [optional] |
 | **status** | **String** | Current status of the endpoint (ACTIVE, INACTIVE, DEPRECATED) | [optional] |
+| **data_time_period_start** | **Time** | Start date of the data time period covered | [optional] |
+| **data_time_period_end** | **Time** | End date of the data time period covered | [optional] |
+| **date_collection_start** | **Time** | When the seller began actively collecting this data. Distinct from data_time_period_start, which describes when the records themselves begin. Backfilled historical data will have date_collection_start > data_time_period_start. | [optional] |
+| **geographic_coverage_type** | **String** | Type of geographic coverage | [optional] |
+| **geographic_coverage_details** | **String** | Specific regions/countries covered (e.g., 'United States, Canada, Mexico') | [optional] |
+| **data_source_refresh_frequency** | **String** | How often the source data is refreshed | [optional] |
 | **tags** | **String** | Comma-separated tags for organizing endpoints | [optional] |
 | **last_accessed** | **Time** | When this endpoint was last called | [optional] |
 | **max_records_per_request** | **Integer** | Seller-enforced row cap per request. Buyers cannot exceed this. Default 1000. | [optional] |
+| **export_enabled** | **Boolean** | Whether this endpoint supports bulk export to GCS. When True, buyers can request delivery=gcs with format=csv|parquet. Independent of max_records_per_request, which only governs inline JSON. | [optional] |
+| **max_records_per_export** | **Integer** | Hard ceiling on rows returned per GCS export. Separate from max_records_per_request so sellers can offer larger downloads via file delivery without expanding inline JSON responses. | [optional] |
 | **sample_response** | **Object** | Last successful {spartera, request, response} envelope. Saved on each successful marketplace run. Displayed as preview on product page load. | [optional] |
 | **active** | **Boolean** | Required. | [optional] |
 
@@ -53,24 +61,32 @@ instance = SparteraApiSdk::EndpointsInput.new(
   approved_by_user_id: approved_by_user_id_abc123,
   approved_at: 2025-04-01T00:00:00Z,
   sell_in_marketplace: true,
-  price_credits: 5.0,
   name: Example Name,
   slug: example-slug,
   description: Example description.,
+  detailed_description: Example description.,
+  top_questions: example_value,
   source_schema_name: Example Name,
   source_table_name: Example Name,
   customer_name: Example Name,
-  price_usd: 5.0,
   endpoint_schema: {},
-  rate_limit_requests: 0.15,
+  rate_limit_number: 0.15,
   rate_limit_period: SECOND,
   rate_limit_granularity: USER,
   access_method: OPEN,
   access_whitelist: {},
   status: ACTIVE,
+  data_time_period_start: 2025-04-01T00:00:00Z,
+  data_time_period_end: 2025-04-01T00:00:00Z,
+  date_collection_start: 2025-04-01T00:00:00Z,
+  geographic_coverage_type: GLOBAL,
+  geographic_coverage_details: example_value,
+  data_source_refresh_frequency: EVERY_SECOND,
   tags: example_value,
   last_accessed: 2025-04-01T00:00:00Z,
   max_records_per_request: 1,
+  export_enabled: true,
+  max_records_per_export: 1,
   sample_response: {},
   active: true
 )

data/docs/EndpointsUpdate.md

@@ -15,24 +15,32 @@
 | **approved_by_user_id** | **String** | User who approved this endpoint for marketplace | [optional] |
 | **approved_at** | **Time** | Timestamp of marketplace approval | [optional] |
 | **sell_in_marketplace** | **Boolean** | Whether this endpoint appears in the public marketplace | [optional] |
-| **price_credits** | **Integer** | Credits deducted from the buyer's pool per successful (200 OK) request. Same credit pool as assets. price_usd kept for billing records / dashboards. | [optional] |
 | **name** | **String** | Human-readable name for the endpoint | [optional] |
 | **slug** | **String** | Human-readable, URL-safe slug derived from name at creation time. e.g. 'NFL Live Moneyline & Spread Odds' → 'nfl-live-moneyline-spread-odds'. Never changes after creation. Unique within company (DB constraint). Creation fails with 409 if a duplicate name exists in the same company. | [optional] |
 | **description** | **String** | Description of what this endpoint provides | [optional] |
+| **detailed_description** | **String** | Long-form HTML description for product pages and SEO | [optional] |
+| **top_questions** | **String** | Top 3 questions this endpoint can help answer, in English. Stored as JSON array of strings (1-3 items, 15-200 chars each). Strongly encouraged for marketplace endpoints but not required — nudge via UI completeness score, not hard validation. | [optional] |
 | **source_schema_name** | **String** | Schema/database name where the table resides | [optional] |
 | **source_table_name** | **String** | Table name to query from | [optional] |
-| **customer_name** | **String** | Named customer for B2B deals (marketplace uses price_credits instead) | [optional] |
-| **price_usd** | **Float** | USD reference price for billing records and seller dashboards | [optional] |
+| **customer_name** | **String** | Named customer for B2B deals (pricing handled via asset_price_history) | [optional] |
 | **endpoint_schema** | **Object** | Column configurations including aggregations, filters, and visibility. Format: {columns: [{name, type, aggregation, filter, is_hidden, alias, ...}]}. This is the source of truth — SQL is generated at runtime from this configuration. | [optional] |
-| **rate_limit_requests** | **Integer** | Number of requests allowed per rate_limit_period | [optional] |
+| **rate_limit_number** | **Integer** | Number of requests allowed per rate_limit_period | [optional] |
 | **rate_limit_period** | **String** | Time period for rate limiting (HOUR, DAY, MONTH) | [optional] |
 | **rate_limit_granularity** | **String** | How to group rate limits (IP, USER, COMPANY, API_KEY, GLOBAL) | [optional] |
 | **access_method** | **String** | Access control method (OPEN, API_KEY, IP, EMAIL, DOMAIN) | [optional] |
 | **access_whitelist** | **Object** | List of allowed IPs, emails, or domains based on access_method. Format: {type: 'ip'|'email'|'domain', values: ['192.168.1.1', ...]} | [optional] |
 | **status** | **String** | Current status of the endpoint (ACTIVE, INACTIVE, DEPRECATED) | [optional] |
+| **data_time_period_start** | **Time** | Start date of the data time period covered | [optional] |
+| **data_time_period_end** | **Time** | End date of the data time period covered | [optional] |
+| **date_collection_start** | **Time** | When the seller began actively collecting this data. Distinct from data_time_period_start, which describes when the records themselves begin. Backfilled historical data will have date_collection_start > data_time_period_start. | [optional] |
+| **geographic_coverage_type** | **String** | Type of geographic coverage | [optional] |
+| **geographic_coverage_details** | **String** | Specific regions/countries covered (e.g., 'United States, Canada, Mexico') | [optional] |
+| **data_source_refresh_frequency** | **String** | How often the source data is refreshed | [optional] |
 | **tags** | **String** | Comma-separated tags for organizing endpoints | [optional] |
 | **last_accessed** | **Time** | When this endpoint was last called | [optional] |
 | **max_records_per_request** | **Integer** | Seller-enforced row cap per request. Buyers cannot exceed this. Default 1000. | [optional] |
+| **export_enabled** | **Boolean** | Whether this endpoint supports bulk export to GCS. When True, buyers can request delivery=gcs with format=csv|parquet. Independent of max_records_per_request, which only governs inline JSON. | [optional] |
+| **max_records_per_export** | **Integer** | Hard ceiling on rows returned per GCS export. Separate from max_records_per_request so sellers can offer larger downloads via file delivery without expanding inline JSON responses. | [optional] |
 | **sample_response** | **Object** | Last successful {spartera, request, response} envelope. Saved on each successful marketplace run. Displayed as preview on product page load. | [optional] |
 | **active** | **Boolean** | Required. | [optional] |
 
@@ -53,24 +61,32 @@ instance = SparteraApiSdk::EndpointsUpdate.new(
   approved_by_user_id: approved_by_user_id_abc123,
   approved_at: 2025-04-01T00:00:00Z,
   sell_in_marketplace: true,
-  price_credits: 5.0,
   name: Example Name,
   slug: example-slug,
   description: Example description.,
+  detailed_description: Example description.,
+  top_questions: example_value,
   source_schema_name: Example Name,
   source_table_name: Example Name,
   customer_name: Example Name,
-  price_usd: 5.0,
   endpoint_schema: {},
-  rate_limit_requests: 0.15,
+  rate_limit_number: 0.15,
   rate_limit_period: SECOND,
   rate_limit_granularity: USER,
   access_method: OPEN,
   access_whitelist: {},
   status: ACTIVE,
+  data_time_period_start: 2025-04-01T00:00:00Z,
+  data_time_period_end: 2025-04-01T00:00:00Z,
+  date_collection_start: 2025-04-01T00:00:00Z,
+  geographic_coverage_type: GLOBAL,
+  geographic_coverage_details: example_value,
+  data_source_refresh_frequency: EVERY_SECOND,
   tags: example_value,
   last_accessed: 2025-04-01T00:00:00Z,
   max_records_per_request: 1,
+  export_enabled: true,
+  max_records_per_export: 1,
   sample_response: {},
   active: true
 )

data/lib/spartera_api_sdk/api/assets_api.rb

@@ -144,40 +144,40 @@ module SparteraApiSdk
     end
 
     # Process (analyze) an asset with dynamic rate limiting applied via decorator.
-    # @param asset_slug [String] URL-friendly slug for the Asset
     # @param company_handle [String] Human-readable handle for the Company
+    # @param asset_slug [String] URL-friendly slug for the Asset
     # @param assets_input [AssetsInput] 
     # @param [Hash] opts the optional parameters
     # @return [CreateAssetsAnalyze200Response]
-    def create_assets_analyze(asset_slug, company_handle, assets_input, opts = {})
-      data, _status_code, _headers = create_assets_analyze_with_http_info(asset_slug, company_handle, assets_input, opts)
+    def create_assets_analyze(company_handle, asset_slug, assets_input, opts = {})
+      data, _status_code, _headers = create_assets_analyze_with_http_info(company_handle, asset_slug, assets_input, opts)
       data
     end
 
     # Process (analyze) an asset with dynamic rate limiting applied via decorator.
-    # @param asset_slug [String] URL-friendly slug for the Asset
     # @param company_handle [String] Human-readable handle for the Company
+    # @param asset_slug [String] URL-friendly slug for the Asset
     # @param assets_input [AssetsInput] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(CreateAssetsAnalyze200Response, Integer, Hash)>] CreateAssetsAnalyze200Response data, response status code and response headers
-    def create_assets_analyze_with_http_info(asset_slug, company_handle, assets_input, opts = {})
+    def create_assets_analyze_with_http_info(company_handle, asset_slug, assets_input, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AssetsApi.create_assets_analyze ...'
       end
-      # verify the required parameter 'asset_slug' is set
-      if @api_client.config.client_side_validation && asset_slug.nil?
-        fail ArgumentError, "Missing the required parameter 'asset_slug' when calling AssetsApi.create_assets_analyze"
-      end
       # verify the required parameter 'company_handle' is set
       if @api_client.config.client_side_validation && company_handle.nil?
         fail ArgumentError, "Missing the required parameter 'company_handle' when calling AssetsApi.create_assets_analyze"
       end
+      # verify the required parameter 'asset_slug' is set
+      if @api_client.config.client_side_validation && asset_slug.nil?
+        fail ArgumentError, "Missing the required parameter 'asset_slug' when calling AssetsApi.create_assets_analyze"
+      end
       # verify the required parameter 'assets_input' is set
       if @api_client.config.client_side_validation && assets_input.nil?
         fail ArgumentError, "Missing the required parameter 'assets_input' when calling AssetsApi.create_assets_analyze"
       end
       # resource path
-      local_var_path = '/analyze/{company_handle}/assets/{asset_slug}'.sub('{' + 'asset_slug' + '}', CGI.escape(asset_slug.to_s)).sub('{' + 'company_handle' + '}', CGI.escape(company_handle.to_s))
+      local_var_path = '/analyze/{company_handle}/assets/{asset_slug}'.sub('{' + 'company_handle' + '}', CGI.escape(company_handle.to_s)).sub('{' + 'asset_slug' + '}', CGI.escape(asset_slug.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -709,34 +709,34 @@ module SparteraApiSdk
     end
 
     # Process (analyze) an asset with dynamic rate limiting applied via decorator.
-    # @param asset_slug [String] URL-friendly slug for the Asset
     # @param company_handle [String] Human-readable handle for the Company
+    # @param asset_slug [String] URL-friendly slug for the Asset
     # @param [Hash] opts the optional parameters
     # @return [GetAssetsByIdAnalyze200Response]
-    def get_assets_by_id_analyze(asset_slug, company_handle, opts = {})
-      data, _status_code, _headers = get_assets_by_id_analyze_with_http_info(asset_slug, company_handle, opts)
+    def get_assets_by_id_analyze(company_handle, asset_slug, opts = {})
+      data, _status_code, _headers = get_assets_by_id_analyze_with_http_info(company_handle, asset_slug, opts)
       data
     end
 
     # Process (analyze) an asset with dynamic rate limiting applied via decorator.
-    # @param asset_slug [String] URL-friendly slug for the Asset
     # @param company_handle [String] Human-readable handle for the Company
+    # @param asset_slug [String] URL-friendly slug for the Asset
     # @param [Hash] opts the optional parameters
     # @return [Array<(GetAssetsByIdAnalyze200Response, Integer, Hash)>] GetAssetsByIdAnalyze200Response data, response status code and response headers
-    def get_assets_by_id_analyze_with_http_info(asset_slug, company_handle, opts = {})
+    def get_assets_by_id_analyze_with_http_info(company_handle, asset_slug, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AssetsApi.get_assets_by_id_analyze ...'
       end
-      # verify the required parameter 'asset_slug' is set
-      if @api_client.config.client_side_validation && asset_slug.nil?
-        fail ArgumentError, "Missing the required parameter 'asset_slug' when calling AssetsApi.get_assets_by_id_analyze"
-      end
       # verify the required parameter 'company_handle' is set
       if @api_client.config.client_side_validation && company_handle.nil?
         fail ArgumentError, "Missing the required parameter 'company_handle' when calling AssetsApi.get_assets_by_id_analyze"
       end
+      # verify the required parameter 'asset_slug' is set
+      if @api_client.config.client_side_validation && asset_slug.nil?
+        fail ArgumentError, "Missing the required parameter 'asset_slug' when calling AssetsApi.get_assets_by_id_analyze"
+      end
       # resource path
-      local_var_path = '/analyze/{company_handle}/assets/{asset_slug}'.sub('{' + 'asset_slug' + '}', CGI.escape(asset_slug.to_s)).sub('{' + 'company_handle' + '}', CGI.escape(company_handle.to_s))
+      local_var_path = '/analyze/{company_handle}/assets/{asset_slug}'.sub('{' + 'company_handle' + '}', CGI.escape(company_handle.to_s)).sub('{' + 'asset_slug' + '}', CGI.escape(asset_slug.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}

data/lib/spartera_api_sdk/api/connections_api.rb

@@ -515,6 +515,99 @@ module SparteraApiSdk
       return data, status_code, headers
     end
 
+    # Get a randomized sample of rows from a table on this connection.     Used by the visualization editor to give sellers data to author against.      Query Parameters:         schema_name (required): Schema/dataset name         table_name  (required): Table name         limit       (optional): Max rows to return (default 1000, max 10000)      Returns columnar data — {column_name: [values]} — ready for Plotly's     dataSources prop. The actual chart at render time will pull fresh data     via the asset's saved SQL; this is only for authoring preview.
+    # @param company_id [String] Unique identifier for the Company
+    # @param connection_id [String] Unique identifier for the Connection
+    # @param [Hash] opts the optional parameters
+    # @return [GetConnectionsById200Response]
+    def get_connections_by_id_sample_data(company_id, connection_id, opts = {})
+      data, _status_code, _headers = get_connections_by_id_sample_data_with_http_info(company_id, connection_id, opts)
+      data
+    end
+
+    # Get a randomized sample of rows from a table on this connection.     Used by the visualization editor to give sellers data to author against.      Query Parameters:         schema_name (required): Schema/dataset name         table_name  (required): Table name         limit       (optional): Max rows to return (default 1000, max 10000)      Returns columnar data — {column_name: [values]} — ready for Plotly's     dataSources prop. The actual chart at render time will pull fresh data     via the asset's saved SQL; this is only for authoring preview.
+    # @param company_id [String] Unique identifier for the Company
+    # @param connection_id [String] Unique identifier for the Connection
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetConnectionsById200Response, Integer, Hash)>] GetConnectionsById200Response data, response status code and response headers
+    def get_connections_by_id_sample_data_with_http_info(company_id, connection_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ConnectionsApi.get_connections_by_id_sample_data ...'
+      end
+      # verify the required parameter 'company_id' is set
+      if @api_client.config.client_side_validation && company_id.nil?
+        fail ArgumentError, "Missing the required parameter 'company_id' when calling ConnectionsApi.get_connections_by_id_sample_data"
+      end
+      if @api_client.config.client_side_validation && company_id.to_s.length > 255
+        fail ArgumentError, 'invalid value for "company_id" when calling ConnectionsApi.get_connections_by_id_sample_data, the character length must be smaller than or equal to 255.'
+      end
+
+      if @api_client.config.client_side_validation && company_id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "company_id" when calling ConnectionsApi.get_connections_by_id_sample_data, the character length must be greater than or equal to 1.'
+      end
+
+      pattern = Regexp.new(/^[a-zA-Z0-9_-]+$/)
+      if @api_client.config.client_side_validation && company_id !~ pattern
+        fail ArgumentError, "invalid value for 'company_id' when calling ConnectionsApi.get_connections_by_id_sample_data, must conform to the pattern #{pattern}."
+      end
+
+      # verify the required parameter 'connection_id' is set
+      if @api_client.config.client_side_validation && connection_id.nil?
+        fail ArgumentError, "Missing the required parameter 'connection_id' when calling ConnectionsApi.get_connections_by_id_sample_data"
+      end
+      if @api_client.config.client_side_validation && connection_id.to_s.length > 255
+        fail ArgumentError, 'invalid value for "connection_id" when calling ConnectionsApi.get_connections_by_id_sample_data, the character length must be smaller than or equal to 255.'
+      end
+
+      if @api_client.config.client_side_validation && connection_id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "connection_id" when calling ConnectionsApi.get_connections_by_id_sample_data, the character length must be greater than or equal to 1.'
+      end
+
+      pattern = Regexp.new(/^[a-zA-Z0-9_-]+$/)
+      if @api_client.config.client_side_validation && connection_id !~ pattern
+        fail ArgumentError, "invalid value for 'connection_id' when calling ConnectionsApi.get_connections_by_id_sample_data, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/companies/{company_id}/connections/{connection_id}/sample-data'.sub('{' + 'company_id' + '}', CGI.escape(company_id.to_s)).sub('{' + 'connection_id' + '}', CGI.escape(connection_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] || 'GetConnectionsById200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"ConnectionsApi.get_connections_by_id_sample_data",
+        :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: ConnectionsApi#get_connections_by_id_sample_data\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get all connections for a specific company
     # @param company_id [String] Unique identifier for the Company
     # @param [Hash] opts the optional parameters