spartera_api_sdk 1.0.82 → 1.0.83

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 132694d5b0f76d8bf60e79a76477b4ba56fdb5a8167db92d3205210ea81b6c10
-  data.tar.gz: 9e7e6bfbb87e2a0d0b6ee6833c6e595a9e88ad6fbd5ddfcc37db685e300b60ee
+  metadata.gz: d8a0910350ab3f5e3d10ca1340416d20dd65ddd6e7961f363384674de4dec534
+  data.tar.gz: 0ce15eeaf84959646673606dbdb14515b4f9e4be259724a5c97401ebc834e022
 SHA512:
-  metadata.gz: 4c44e9bb72a75e92520194e76530730db72032d4c91fbf3713c05902426cfb6ab2f01857d00f0d5d8b5d1cf55e0598368d230fc133fa677313f3476fc63434b9
-  data.tar.gz: 9080939d0a169047b7f0e2094a5245395110ff4f0e2af0b902cd4f0bff27a6b8cc12673637bf10eb5804a27bfd53ea9a01c6a1cfed52490f9c4ba27497cd00fb
+  metadata.gz: e458fedd88bc3168c301f1dc08736d878bde9c57eb696a650d3dc238b88fd1d42d6ff2021bc488ec910b18767efcdbc7c90b5d7ec5350d752313134be86d1730
+  data.tar.gz: 981ba49f778ca746ca620acc22b8f482d5ffa0363840719a9bbd2088f241ad24c928df46f7c5d6fec3c1a184e1f0dcf325157aac32fbfd4126977d85d6a1b7a9

data/README.md

@@ -7,7 +7,7 @@ Auto-generated API documentation for REST services of the Spartera platform
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 1.25.0
-- Package version: 1.0.82
+- Package version: 1.0.83
 - Generator version: 7.21.0
 - Build package: org.openapitools.codegen.languages.RubyClientCodegen
 
@@ -24,16 +24,16 @@ gem build spartera_api_sdk.gemspec
 Then either install the gem locally:
 
 ```shell
-gem install ./spartera_api_sdk-1.0.82.gem
+gem install ./spartera_api_sdk-1.0.83.gem
 ```
 
-(for development, run `gem install --dev ./spartera_api_sdk-1.0.82.gem` to install the development dependencies)
+(for development, run `gem install --dev ./spartera_api_sdk-1.0.83.gem` to install the development dependencies)
 
 or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
 
 Finally add this to the Gemfile:
 
-    gem 'spartera_api_sdk', '~> 1.0.82'
+    gem 'spartera_api_sdk', '~> 1.0.83'
 
 ### Install from Git
 
@@ -149,10 +149,12 @@ Class | Method | HTTP request | Description
 *SparteraApiSdk::ConnectionsApi* | [**get_connections_by_id**](docs/ConnectionsApi.md#get_connections_by_id) | **GET** /companies/{company_id}/connections/{connection_id} | Get single connection by ID
 *SparteraApiSdk::ConnectionsApi* | [**get_connections_by_id2**](docs/ConnectionsApi.md#get_connections_by_id2) | **GET** /companies/{company_id}/connections/{connection_id}/test | Test the specified connection
 *SparteraApiSdk::ConnectionsApi* | [**get_connections_by_id_infoschema**](docs/ConnectionsApi.md#get_connections_by_id_infoschema) | **GET** /companies/{company_id}/connections/{connection_id}/infoschema | Retrieve the information schema for the specified connection
+*SparteraApiSdk::ConnectionsApi* | [**get_connections_by_id_sample_data**](docs/ConnectionsApi.md#get_connections_by_id_sample_data) | **GET** /companies/{company_id}/connections/{connection_id}/sample-data | 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.
 *SparteraApiSdk::ConnectionsApi* | [**list_connections**](docs/ConnectionsApi.md#list_connections) | **GET** /companies/{company_id}/connections | Get all connections for a specific company
 *SparteraApiSdk::ConnectionsApi* | [**update_connections**](docs/ConnectionsApi.md#update_connections) | **PATCH** /companies/{company_id}/connections/{connection_id} | Update an existing connection by ID
 *SparteraApiSdk::EndpointsApi* | [**create_endpoints**](docs/EndpointsApi.md#create_endpoints) | **POST** /companies/{company_id}/endpoints | Create a new endpoint
 *SparteraApiSdk::EndpointsApi* | [**create_endpoints_keys**](docs/EndpointsApi.md#create_endpoints_keys) | **POST** /companies/{company_id}/endpoints/{endpoint_id}/keys | POST /companies/{company_id}/endpoints/{endpoint_id}/keys
+*SparteraApiSdk::EndpointsApi* | [**create_endpoints_scan_column**](docs/EndpointsApi.md#create_endpoints_scan_column) | **POST** /companies/{company_id}/endpoints/{endpoint_id}/scan_column | POST /companies/{company_id}/endpoints/{endpoint_id}/scan_column
 *SparteraApiSdk::EndpointsApi* | [**delete_endpoints**](docs/EndpointsApi.md#delete_endpoints) | **DELETE** /companies/{company_id}/endpoints/{endpoint_id} | Delete single endpoint by ID
 *SparteraApiSdk::EndpointsApi* | [**delete_endpoints_keys**](docs/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}
 *SparteraApiSdk::EndpointsApi* | [**get_endpoints_by_id**](docs/EndpointsApi.md#get_endpoints_by_id) | **GET** /companies/{company_id}/endpoints/{endpoint_id} | Get single endpoint by ID
@@ -160,6 +162,7 @@ Class | Method | HTTP request | Description
 *SparteraApiSdk::EndpointsApi* | [**get_endpoints_by_id_connections_describe**](docs/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
 *SparteraApiSdk::EndpointsApi* | [**get_endpoints_by_id_execute**](docs/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
 *SparteraApiSdk::EndpointsApi* | [**get_endpoints_by_id_keys**](docs/EndpointsApi.md#get_endpoints_by_id_keys) | **GET** /companies/{company_id}/endpoints/{endpoint_id}/keys | GET /companies/{company_id}/endpoints/{endpoint_id}/keys
+*SparteraApiSdk::EndpointsApi* | [**get_endpoints_by_id_recommendations**](docs/EndpointsApi.md#get_endpoints_by_id_recommendations) | **GET** /companies/{company_id}/endpoints/{endpoint_id}/recommendations | GET /companies/{company_id}/endpoints/{endpoint_id}/recommendations
 *SparteraApiSdk::EndpointsApi* | [**get_endpoints_by_id_stats**](docs/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)
 *SparteraApiSdk::EndpointsApi* | [**get_endpoints_by_id_test**](docs/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)
 *SparteraApiSdk::EndpointsApi* | [**get_endpoints_by_id_url**](docs/EndpointsApi.md#get_endpoints_by_id_url) | **GET** /companies/{company_id}/endpoints/{endpoint_id}/url | GET /companies/{company_id}/endpoints/{endpoint_id}/url

data/docs/Assets.md

@@ -28,6 +28,7 @@
 | **asset_schema** | **Object** | Stores database table schema data including columns, types, and metadata | [optional] |
 | **visibility** | **String** | Optional. One of: PRIVATE, SHARED. | [optional] |
 | **tags** | **String** | Optional. | [optional] |
+| **top_questions** | **String** | Top 3 questions this asset can help answer, in English. Stored as JSON array of strings (1-3 items, 15-200 chars each). Required for marketplace assets. | [optional] |
 | **short_code** | **String** | Short code for tera.ac URL shortener (e.g., 'f78zq1') | [optional] |
 | **restricted_domains** | **String** | Semicolon or comma-separated list of domains restricted from accessing this asset | [optional] |
 | **sql_logic** | **String** | Optional. | [optional] |
@@ -35,6 +36,7 @@
 | **source_table_name** | **String** | Optional. | [optional] |
 | **sell_in_marketplace** | **Boolean** | Required. |  |
 | **require_customization** | **Boolean** | Whether this asset requires customization before use |  |
+| **viz_spec** | **Object** | Plotly figure JSON describing the visualization. Authored via the visual editor or via API. When populated, takes precedence over the legacy viz_* fields. Shape follows Plotly's figure schema: {data: [{type: '...', xsrc: '...', ...}], layout: {...}}. Column references use *src keys (xsrc, ysrc, labelssrc, etc.) and are hydrated with actual data at render time. | [optional] |
 | **viz_chart_library** | **String** | Optional. One of: PLOTLY, MATPLOTLIB, SEABORN. | [optional] |
 | **viz_chart_type** | **String** | Optional. One of: LINE, BAR, PIE, DOUGHNUT, POLAR, … (8 total). | [optional] |
 | **viz_dep_var_col_name** | **String** | Optional. | [optional] |
@@ -58,10 +60,10 @@
 | **next_run** | **Time** | Optional. | [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] |
-| **data_source_last_refreshed** | **Time** | When the source data was last refreshed | [optional] |
 | **rate_limit_number** | **Integer** | Number of requests allowed per period (e.g., 100) | [optional] |
 | **rate_limit_period** | **String** | Time period for rate limiting (second, minute, hour, day) | [optional] |
 | **rate_limit_granularity** | **String** | Granularity level for rate limiting (USER, COMPANY, IP) | [optional] |
@@ -96,6 +98,7 @@ instance = SparteraApiSdk::Assets.new(
   asset_schema: {},
   visibility: PRIVATE,
   tags: example_value,
+  top_questions: example_value,
   short_code: ABC123,
   restricted_domains: example.com,
   sql_logic: example_value,
@@ -103,6 +106,7 @@ instance = SparteraApiSdk::Assets.new(
   source_table_name: Example Name,
   sell_in_marketplace: true,
   require_customization: true,
+  viz_spec: {},
   viz_chart_library: PLOTLY,
   viz_chart_type: LINE,
   viz_dep_var_col_name: Example Name,
@@ -126,10 +130,10 @@ instance = SparteraApiSdk::Assets.new(
   next_run: 2025-04-01T00:00:00Z,
   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: REAL_TIME,
-  data_source_last_refreshed: 2025-04-01T00:00:00Z,
+  data_source_refresh_frequency: EVERY_SECOND,
   rate_limit_number: 0.15,
   rate_limit_period: SECOND,
   rate_limit_granularity: USER

data/docs/AssetsApi.md

@@ -107,7 +107,7 @@ end
 
 ## create_assets_analyze
 
-> <CreateAssetsAnalyze200Response> create_assets_analyze(asset_slug, company_handle, assets_input)
+> <CreateAssetsAnalyze200Response> create_assets_analyze(company_handle, asset_slug, assets_input)
 
 Process (analyze) an asset with dynamic rate limiting applied via decorator.
 
@@ -125,13 +125,13 @@ SparteraApiSdk.configure do |config|
 end
 
 api_instance = SparteraApiSdk::AssetsApi.new
-asset_slug = 'asset_slug_example' # String | URL-friendly slug for the Asset
 company_handle = 'company_handle_example' # String | Human-readable handle for the Company
+asset_slug = 'asset_slug_example' # String | URL-friendly slug for the Asset
 assets_input = SparteraApiSdk::AssetsInput.new({company_id: 'company_id_abc123', name: 'Example Name', source: 'MANUAL'}) # AssetsInput | 
 
 begin
   # Process (analyze) an asset with dynamic rate limiting applied via decorator.
-  result = api_instance.create_assets_analyze(asset_slug, company_handle, assets_input)
+  result = api_instance.create_assets_analyze(company_handle, asset_slug, assets_input)
   p result
 rescue SparteraApiSdk::ApiError => e
   puts "Error when calling AssetsApi->create_assets_analyze: #{e}"
@@ -142,12 +142,12 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<CreateAssetsAnalyze200Response>, Integer, Hash)> create_assets_analyze_with_http_info(asset_slug, company_handle, assets_input)
+> <Array(<CreateAssetsAnalyze200Response>, Integer, Hash)> create_assets_analyze_with_http_info(company_handle, asset_slug, assets_input)
 
 ```ruby
 begin
   # Process (analyze) an asset with dynamic rate limiting applied via decorator.
-  data, status_code, headers = api_instance.create_assets_analyze_with_http_info(asset_slug, company_handle, assets_input)
+  data, status_code, headers = api_instance.create_assets_analyze_with_http_info(company_handle, asset_slug, assets_input)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <CreateAssetsAnalyze200Response>
@@ -160,8 +160,8 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **asset_slug** | **String** | URL-friendly slug for the Asset |  |
 | **company_handle** | **String** | Human-readable handle for the Company |  |
+| **asset_slug** | **String** | URL-friendly slug for the Asset |  |
 | **assets_input** | [**AssetsInput**](AssetsInput.md) |  |  |
 
 ### Return type
@@ -539,7 +539,7 @@ end
 
 ## get_assets_by_id_analyze
 
-> <GetAssetsByIdAnalyze200Response> get_assets_by_id_analyze(asset_slug, company_handle)
+> <GetAssetsByIdAnalyze200Response> get_assets_by_id_analyze(company_handle, asset_slug)
 
 Process (analyze) an asset with dynamic rate limiting applied via decorator.
 
@@ -557,12 +557,12 @@ SparteraApiSdk.configure do |config|
 end
 
 api_instance = SparteraApiSdk::AssetsApi.new
-asset_slug = 'asset_slug_example' # String | URL-friendly slug for the Asset
 company_handle = 'company_handle_example' # String | Human-readable handle for the Company
+asset_slug = 'asset_slug_example' # String | URL-friendly slug for the Asset
 
 begin
   # Process (analyze) an asset with dynamic rate limiting applied via decorator.
-  result = api_instance.get_assets_by_id_analyze(asset_slug, company_handle)
+  result = api_instance.get_assets_by_id_analyze(company_handle, asset_slug)
   p result
 rescue SparteraApiSdk::ApiError => e
   puts "Error when calling AssetsApi->get_assets_by_id_analyze: #{e}"
@@ -573,12 +573,12 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<GetAssetsByIdAnalyze200Response>, Integer, Hash)> get_assets_by_id_analyze_with_http_info(asset_slug, company_handle)
+> <Array(<GetAssetsByIdAnalyze200Response>, Integer, Hash)> get_assets_by_id_analyze_with_http_info(company_handle, asset_slug)
 
 ```ruby
 begin
   # Process (analyze) an asset with dynamic rate limiting applied via decorator.
-  data, status_code, headers = api_instance.get_assets_by_id_analyze_with_http_info(asset_slug, company_handle)
+  data, status_code, headers = api_instance.get_assets_by_id_analyze_with_http_info(company_handle, asset_slug)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <GetAssetsByIdAnalyze200Response>
@@ -591,8 +591,8 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **asset_slug** | **String** | URL-friendly slug for the Asset |  |
 | **company_handle** | **String** | Human-readable handle for the Company |  |
+| **asset_slug** | **String** | URL-friendly slug for the Asset |  |
 
 ### Return type
 

data/docs/AssetsInput.md

@@ -21,6 +21,7 @@
 | **asset_type** | **String** | Optional. One of: CALCULATION, VISUALIZATION, DATA. | [optional] |
 | **asset_schema** | **Object** | Stores database table schema data including columns, types, and metadata | [optional] |
 | **tags** | **String** | Optional. | [optional] |
+| **top_questions** | **String** | Top 3 questions this asset can help answer, in English. Stored as JSON array of strings (1-3 items, 15-200 chars each). Required for marketplace assets. | [optional] |
 | **short_code** | **String** | Short code for tera.ac URL shortener (e.g., 'f78zq1') | [optional] |
 | **restricted_domains** | **String** | Semicolon or comma-separated list of domains restricted from accessing this asset | [optional] |
 | **sql_logic** | **String** | Optional. | [optional] |
@@ -28,6 +29,7 @@
 | **source_table_name** | **String** | Optional. | [optional] |
 | **sell_in_marketplace** | **Boolean** | Required. | [optional] |
 | **require_customization** | **Boolean** | Whether this asset requires customization before use | [optional] |
+| **viz_spec** | **Object** | Plotly figure JSON describing the visualization. Authored via the visual editor or via API. When populated, takes precedence over the legacy viz_* fields. Shape follows Plotly's figure schema: {data: [{type: '...', xsrc: '...', ...}], layout: {...}}. Column references use *src keys (xsrc, ysrc, labelssrc, etc.) and are hydrated with actual data at render time. | [optional] |
 | **viz_chart_library** | **String** | Optional. One of: PLOTLY, MATPLOTLIB, SEABORN. | [optional] |
 | **viz_chart_type** | **String** | Optional. One of: LINE, BAR, PIE, DOUGHNUT, POLAR, … (8 total). | [optional] |
 | **viz_dep_var_col_name** | **String** | Optional. | [optional] |
@@ -51,10 +53,10 @@
 | **next_run** | **Time** | Optional. | [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] |
-| **data_source_last_refreshed** | **Time** | When the source data was last refreshed | [optional] |
 | **rate_limit_number** | **Integer** | Number of requests allowed per period (e.g., 100) | [optional] |
 | **rate_limit_period** | **String** | Time period for rate limiting (second, minute, hour, day) | [optional] |
 | **rate_limit_granularity** | **String** | Granularity level for rate limiting (USER, COMPANY, IP) | [optional] |
@@ -82,6 +84,7 @@ instance = SparteraApiSdk::AssetsInput.new(
   asset_type: CALCULATION,
   asset_schema: {},
   tags: example_value,
+  top_questions: example_value,
   short_code: ABC123,
   restricted_domains: example.com,
   sql_logic: example_value,
@@ -89,6 +92,7 @@ instance = SparteraApiSdk::AssetsInput.new(
   source_table_name: Example Name,
   sell_in_marketplace: true,
   require_customization: true,
+  viz_spec: {},
   viz_chart_library: PLOTLY,
   viz_chart_type: LINE,
   viz_dep_var_col_name: Example Name,
@@ -112,10 +116,10 @@ instance = SparteraApiSdk::AssetsInput.new(
   next_run: 2025-04-01T00:00:00Z,
   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: REAL_TIME,
-  data_source_last_refreshed: 2025-04-01T00:00:00Z,
+  data_source_refresh_frequency: EVERY_SECOND,
   rate_limit_number: 0.15,
   rate_limit_period: SECOND,
   rate_limit_granularity: USER

data/docs/AssetsUpdate.md

@@ -21,6 +21,7 @@
 | **asset_type** | **String** | Optional. One of: CALCULATION, VISUALIZATION, DATA. | [optional] |
 | **asset_schema** | **Object** | Stores database table schema data including columns, types, and metadata | [optional] |
 | **tags** | **String** | Optional. | [optional] |
+| **top_questions** | **String** | Top 3 questions this asset can help answer, in English. Stored as JSON array of strings (1-3 items, 15-200 chars each). Required for marketplace assets. | [optional] |
 | **short_code** | **String** | Short code for tera.ac URL shortener (e.g., 'f78zq1') | [optional] |
 | **restricted_domains** | **String** | Semicolon or comma-separated list of domains restricted from accessing this asset | [optional] |
 | **sql_logic** | **String** | Optional. | [optional] |
@@ -28,6 +29,7 @@
 | **source_table_name** | **String** | Optional. | [optional] |
 | **sell_in_marketplace** | **Boolean** | Required. | [optional] |
 | **require_customization** | **Boolean** | Whether this asset requires customization before use | [optional] |
+| **viz_spec** | **Object** | Plotly figure JSON describing the visualization. Authored via the visual editor or via API. When populated, takes precedence over the legacy viz_* fields. Shape follows Plotly's figure schema: {data: [{type: '...', xsrc: '...', ...}], layout: {...}}. Column references use *src keys (xsrc, ysrc, labelssrc, etc.) and are hydrated with actual data at render time. | [optional] |
 | **viz_chart_library** | **String** | Optional. One of: PLOTLY, MATPLOTLIB, SEABORN. | [optional] |
 | **viz_chart_type** | **String** | Optional. One of: LINE, BAR, PIE, DOUGHNUT, POLAR, … (8 total). | [optional] |
 | **viz_dep_var_col_name** | **String** | Optional. | [optional] |
@@ -51,10 +53,10 @@
 | **next_run** | **Time** | Optional. | [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] |
-| **data_source_last_refreshed** | **Time** | When the source data was last refreshed | [optional] |
 | **rate_limit_number** | **Integer** | Number of requests allowed per period (e.g., 100) | [optional] |
 | **rate_limit_period** | **String** | Time period for rate limiting (second, minute, hour, day) | [optional] |
 | **rate_limit_granularity** | **String** | Granularity level for rate limiting (USER, COMPANY, IP) | [optional] |
@@ -82,6 +84,7 @@ instance = SparteraApiSdk::AssetsUpdate.new(
   asset_type: CALCULATION,
   asset_schema: {},
   tags: example_value,
+  top_questions: example_value,
   short_code: ABC123,
   restricted_domains: example.com,
   sql_logic: example_value,
@@ -89,6 +92,7 @@ instance = SparteraApiSdk::AssetsUpdate.new(
   source_table_name: Example Name,
   sell_in_marketplace: true,
   require_customization: true,
+  viz_spec: {},
   viz_chart_library: PLOTLY,
   viz_chart_type: LINE,
   viz_dep_var_col_name: Example Name,
@@ -112,10 +116,10 @@ instance = SparteraApiSdk::AssetsUpdate.new(
   next_run: 2025-04-01T00:00:00Z,
   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: REAL_TIME,
-  data_source_last_refreshed: 2025-04-01T00:00:00Z,
+  data_source_refresh_frequency: EVERY_SECOND,
   rate_limit_number: 0.15,
   rate_limit_period: SECOND,
   rate_limit_granularity: USER

data/docs/Connections.md

@@ -10,7 +10,7 @@
 | **user_id** | **String** | References users.user_id — An individual user account within a company. See GET /users for valid values. Optional. | [optional] |
 | **engine_id** | **Integer** | References storage_engines.engine_id — Fact table of all the different storage engines we support. See GET /storage_engines for valid values. Required. |  |
 | **company_id** | **String** | References companies.company_id — A Spartera seller or buyer company account. See GET /companies for valid values. Required. |  |
-| **credential_type** | **String** | Optional. One of: SERVICE_ACCOUNT, USERNAME_PASSWORD, API_KEY, SERVICE_IDENTITY, ACCESS_KEY, … (8 total). | [optional] |
+| **credential_type** | **String** | Optional. One of: SERVICE_ACCOUNT, USERNAME_PASSWORD, API_KEY, SERVICE_IDENTITY, ACCESS_KEY, … (10 total). | [optional] |
 | **name** | **String** | Optional. | [optional] |
 | **description** | **String** | Optional. | [optional] |
 | **provider_domain** | **String** | Domain of the external API provider (e.g., 'api.weather.com') | [optional] |

data/docs/ConnectionsApi.md

@@ -9,6 +9,7 @@ All URIs are relative to *https://api.spartera.com*
 | [**get_connections_by_id**](ConnectionsApi.md#get_connections_by_id) | **GET** /companies/{company_id}/connections/{connection_id} | Get single connection by ID |
 | [**get_connections_by_id2**](ConnectionsApi.md#get_connections_by_id2) | **GET** /companies/{company_id}/connections/{connection_id}/test | Test the specified connection |
 | [**get_connections_by_id_infoschema**](ConnectionsApi.md#get_connections_by_id_infoschema) | **GET** /companies/{company_id}/connections/{connection_id}/infoschema | Retrieve the information schema for the specified connection |
+| [**get_connections_by_id_sample_data**](ConnectionsApi.md#get_connections_by_id_sample_data) | **GET** /companies/{company_id}/connections/{connection_id}/sample-data | 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. |
 | [**list_connections**](ConnectionsApi.md#list_connections) | **GET** /companies/{company_id}/connections | Get all connections for a specific company |
 | [**update_connections**](ConnectionsApi.md#update_connections) | **PATCH** /companies/{company_id}/connections/{connection_id} | Update an existing connection by ID |
 
@@ -380,6 +381,77 @@ end
 - **Accept**: application/json
 
 
+## get_connections_by_id_sample_data
+
+> <GetConnectionsById200Response> get_connections_by_id_sample_data(company_id, connection_id)
+
+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.
+
+### 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::ConnectionsApi.new
+company_id = 'company_id_example' # String | Unique identifier for the Company
+connection_id = 'connection_id_example' # String | Unique identifier for the Connection
+
+begin
+  # 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.
+  result = api_instance.get_connections_by_id_sample_data(company_id, connection_id)
+  p result
+rescue SparteraApiSdk::ApiError => e
+  puts "Error when calling ConnectionsApi->get_connections_by_id_sample_data: #{e}"
+end
+```
+
+#### Using the get_connections_by_id_sample_data_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetConnectionsById200Response>, Integer, Hash)> get_connections_by_id_sample_data_with_http_info(company_id, connection_id)
+
+```ruby
+begin
+  # 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.
+  data, status_code, headers = api_instance.get_connections_by_id_sample_data_with_http_info(company_id, connection_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetConnectionsById200Response>
+rescue SparteraApiSdk::ApiError => e
+  puts "Error when calling ConnectionsApi->get_connections_by_id_sample_data_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **company_id** | **String** | Unique identifier for the Company |  |
+| **connection_id** | **String** | Unique identifier for the Connection |  |
+
+### Return type
+
+[**GetConnectionsById200Response**](GetConnectionsById200Response.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## list_connections
 
 > <ListConnections200Response> list_connections(company_id, opts)

data/docs/ConnectionsInput.md

@@ -7,7 +7,7 @@
 | **user_id** | **String** | References users.user_id — An individual user account within a company. See GET /users for valid values. Optional. | [optional] |
 | **engine_id** | **Integer** | References storage_engines.engine_id — Fact table of all the different storage engines we support. See GET /storage_engines for valid values. Required. |  |
 | **company_id** | **String** | References companies.company_id — A Spartera seller or buyer company account. See GET /companies for valid values. Required. |  |
-| **credential_type** | **String** | Optional. One of: SERVICE_ACCOUNT, USERNAME_PASSWORD, API_KEY, SERVICE_IDENTITY, ACCESS_KEY, … (8 total). | [optional] |
+| **credential_type** | **String** | Optional. One of: SERVICE_ACCOUNT, USERNAME_PASSWORD, API_KEY, SERVICE_IDENTITY, ACCESS_KEY, … (10 total). | [optional] |
 | **name** | **String** | Optional. | [optional] |
 | **description** | **String** | Optional. | [optional] |
 | **provider_domain** | **String** | Domain of the external API provider (e.g., 'api.weather.com') | [optional] |

data/docs/ConnectionsUpdate.md

@@ -7,7 +7,7 @@
 | **user_id** | **String** | References users.user_id — An individual user account within a company. See GET /users for valid values. Optional. | [optional] |
 | **engine_id** | **Integer** | References storage_engines.engine_id — Fact table of all the different storage engines we support. See GET /storage_engines for valid values. Required. | [optional] |
 | **company_id** | **String** | References companies.company_id — A Spartera seller or buyer company account. See GET /companies for valid values. Required. | [optional] |
-| **credential_type** | **String** | Optional. One of: SERVICE_ACCOUNT, USERNAME_PASSWORD, API_KEY, SERVICE_IDENTITY, ACCESS_KEY, … (8 total). | [optional] |
+| **credential_type** | **String** | Optional. One of: SERVICE_ACCOUNT, USERNAME_PASSWORD, API_KEY, SERVICE_IDENTITY, ACCESS_KEY, … (10 total). | [optional] |
 | **name** | **String** | Optional. | [optional] |
 | **description** | **String** | Optional. | [optional] |
 | **provider_domain** | **String** | Domain of the external API provider (e.g., 'api.weather.com') | [optional] |

data/docs/Endpoints.md

@@ -16,24 +16,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 |  |
-| **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. |  |
 | **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) |  |
+| **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. |  |
+| **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. |  |
 
@@ -55,24 +63,32 @@ instance = SparteraApiSdk::Endpoints.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
 )