spartera_api_sdk 1.0.77 → 1.0.78

data/docs/CompaniesApi.md

@@ -4,22 +4,23 @@ All URIs are relative to *https://api.spartera.com*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
-| [**companies_company_id_analytics_assets_get**](CompaniesApi.md#companies_company_id_analytics_assets_get) | **GET** /companies/{company_id}/analytics/assets | Get asset performance analytics     Query params: start_date, end_date, limit, sort_by, include |
-| [**companies_company_id_analytics_customers_get**](CompaniesApi.md#companies_company_id_analytics_customers_get) | **GET** /companies/{company_id}/analytics/customers | Get customer analytics including growth and segmentation     Query params: start_date, end_date, group_by, segment_by |
-| [**companies_company_id_analytics_dashboard_get**](CompaniesApi.md#companies_company_id_analytics_dashboard_get) | **GET** /companies/{company_id}/analytics/dashboard | Get comprehensive dashboard analytics for seller dashboard     Includes all metrics needed for dashboard charts in one call     Query params: start_date, end_date, period (day/week/month/quarter) |
-| [**companies_company_id_analytics_sales_get**](CompaniesApi.md#companies_company_id_analytics_sales_get) | **GET** /companies/{company_id}/analytics/sales | Get sales over time analytics     Query params: start_date, end_date, group_by (day/week/month/quarter), metrics |
-| [**companies_company_id_get**](CompaniesApi.md#companies_company_id_get) | **GET** /companies/{company_id} | Get details of the requestor's own company |
-| [**companies_company_id_objects_get**](CompaniesApi.md#companies_company_id_objects_get) | **GET** /companies/{company_id}/objects | Get all objects (connections, assets) of a single company |
-| [**companies_company_id_patch**](CompaniesApi.md#companies_company_id_patch) | **PATCH** /companies/{company_id} | Update an existing company by ID |
-| [**companies_company_id_requests_plan_get**](CompaniesApi.md#companies_company_id_requests_plan_get) | **GET** /companies/{company_id}/requests/plan | Get the total number of requests allocated in the company's current subscription plan. |
-| [**companies_company_id_requests_usage_get**](CompaniesApi.md#companies_company_id_requests_usage_get) | **GET** /companies/{company_id}/requests/usage | Get company request usage data for a specific month. Returns JSON metrics by default or CSV logs when download parameter is included. |
+| [**get_companies_by_id**](CompaniesApi.md#get_companies_by_id) | **GET** /companies/{company_id} | Get details of the requestor's own company |
+| [**list_companies**](CompaniesApi.md#list_companies) | **GET** /companies/{company_id}/requests/plan | Get the total number of requests allocated in the company's current subscription plan. |
+| [**list_companies_analytics_assets**](CompaniesApi.md#list_companies_analytics_assets) | **GET** /companies/{company_id}/analytics/assets | Get asset performance analytics.     Query params: start_date, end_date, limit, sort_by, include |
+| [**list_companies_analytics_customers**](CompaniesApi.md#list_companies_analytics_customers) | **GET** /companies/{company_id}/analytics/customers | Get customer analytics including growth and segmentation.     Query params: start_date, end_date, group_by, segment_by |
+| [**list_companies_analytics_dashboard**](CompaniesApi.md#list_companies_analytics_dashboard) | **GET** /companies/{company_id}/analytics/dashboard | Get comprehensive dashboard analytics for seller dashboard.     Query params: start_date, end_date, period (day/week/month/quarter) |
+| [**list_companies_analytics_metrics**](CompaniesApi.md#list_companies_analytics_metrics) | **GET** /companies/{company_id}/analytics/metrics | Get summary metrics (counts only). No date params needed — returns all-time totals.     Performance: < 0.1s |
+| [**list_companies_analytics_sales**](CompaniesApi.md#list_companies_analytics_sales) | **GET** /companies/{company_id}/analytics/sales | Get sales over time analytics.     Query params: start_date, end_date, group_by (day/week/month/quarter), metrics |
+| [**list_companies_objects**](CompaniesApi.md#list_companies_objects) | **GET** /companies/{company_id}/objects | Get all objects (connections, assets) of a single company |
+| [**list_companies_requests_usage**](CompaniesApi.md#list_companies_requests_usage) | **GET** /companies/{company_id}/requests/usage | Get company request usage data for a specific month. |
+| [**update_companies**](CompaniesApi.md#update_companies) | **PATCH** /companies/{company_id} | Update an existing company by ID |
 
 
-## companies_company_id_analytics_assets_get
+## get_companies_by_id
 
-> <CompaniesCompanyIdAnalyticsAssetsGet200Response> companies_company_id_analytics_assets_get(company_id)
+> <GetCompaniesById200Response> get_companies_by_id(company_id)
 
-Get asset performance analytics     Query params: start_date, end_date, limit, sort_by, include
+Get details of the requestor's own company
 
 ### Examples
 
@@ -35,32 +36,32 @@ SparteraApiSdk.configure do |config|
 end
 
 api_instance = SparteraApiSdk::CompaniesApi.new
-company_id = 'company_id_example' # String | 
+company_id = 'company_id_example' # String | Unique identifier for the Company
 
 begin
-  # Get asset performance analytics     Query params: start_date, end_date, limit, sort_by, include
-  result = api_instance.companies_company_id_analytics_assets_get(company_id)
+  # Get details of the requestor's own company
+  result = api_instance.get_companies_by_id(company_id)
   p result
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_analytics_assets_get: #{e}"
+  puts "Error when calling CompaniesApi->get_companies_by_id: #{e}"
 end
 ```
 
-#### Using the companies_company_id_analytics_assets_get_with_http_info variant
+#### Using the get_companies_by_id_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<CompaniesCompanyIdAnalyticsAssetsGet200Response>, Integer, Hash)> companies_company_id_analytics_assets_get_with_http_info(company_id)
+> <Array(<GetCompaniesById200Response>, Integer, Hash)> get_companies_by_id_with_http_info(company_id)
 
 ```ruby
 begin
-  # Get asset performance analytics     Query params: start_date, end_date, limit, sort_by, include
-  data, status_code, headers = api_instance.companies_company_id_analytics_assets_get_with_http_info(company_id)
+  # Get details of the requestor's own company
+  data, status_code, headers = api_instance.get_companies_by_id_with_http_info(company_id)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <CompaniesCompanyIdAnalyticsAssetsGet200Response>
+  p data # => <GetCompaniesById200Response>
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_analytics_assets_get_with_http_info: #{e}"
+  puts "Error when calling CompaniesApi->get_companies_by_id_with_http_info: #{e}"
 end
 ```
 
@@ -68,11 +69,11 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **company_id** | **String** |  |  |
+| **company_id** | **String** | Unique identifier for the Company |  |
 
 ### Return type
 
-[**CompaniesCompanyIdAnalyticsAssetsGet200Response**](CompaniesCompanyIdAnalyticsAssetsGet200Response.md)
+[**GetCompaniesById200Response**](GetCompaniesById200Response.md)
 
 ### Authorization
 
@@ -84,11 +85,11 @@ end
 - **Accept**: application/json
 
 
-## companies_company_id_analytics_customers_get
+## list_companies
 
-> <CompaniesCompanyIdAnalyticsAssetsGet200Response> companies_company_id_analytics_customers_get(company_id)
+> <ListCompaniesAnalyticsAssets200Response> list_companies(company_id, opts)
 
-Get customer analytics including growth and segmentation     Query params: start_date, end_date, group_by, segment_by
+Get the total number of requests allocated in the company's current subscription plan.
 
 ### Examples
 
@@ -104,32 +105,39 @@ SparteraApiSdk.configure do |config|
 end
 
 api_instance = SparteraApiSdk::CompaniesApi.new
-company_id = 'company_id_example' # String | 
+company_id = 'company_id_example' # String | Unique identifier for the Company
+opts = {
+  page: 56, # Integer | Page number for pagination
+  limit: 56, # Integer | Number of items per page
+  sort_by: 'sort_by_example', # String | Field to sort by
+  sort_order: 'asc', # String | Sort order (ascending or descending)
+  search: 'search_example' # String | Search term to filter results
+}
 
 begin
-  # Get customer analytics including growth and segmentation     Query params: start_date, end_date, group_by, segment_by
-  result = api_instance.companies_company_id_analytics_customers_get(company_id)
+  # Get the total number of requests allocated in the company's current subscription plan.
+  result = api_instance.list_companies(company_id, opts)
   p result
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_analytics_customers_get: #{e}"
+  puts "Error when calling CompaniesApi->list_companies: #{e}"
 end
 ```
 
-#### Using the companies_company_id_analytics_customers_get_with_http_info variant
+#### Using the list_companies_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<CompaniesCompanyIdAnalyticsAssetsGet200Response>, Integer, Hash)> companies_company_id_analytics_customers_get_with_http_info(company_id)
+> <Array(<ListCompaniesAnalyticsAssets200Response>, Integer, Hash)> list_companies_with_http_info(company_id, opts)
 
 ```ruby
 begin
-  # Get customer analytics including growth and segmentation     Query params: start_date, end_date, group_by, segment_by
-  data, status_code, headers = api_instance.companies_company_id_analytics_customers_get_with_http_info(company_id)
+  # Get the total number of requests allocated in the company's current subscription plan.
+  data, status_code, headers = api_instance.list_companies_with_http_info(company_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <CompaniesCompanyIdAnalyticsAssetsGet200Response>
+  p data # => <ListCompaniesAnalyticsAssets200Response>
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_analytics_customers_get_with_http_info: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_with_http_info: #{e}"
 end
 ```
 
@@ -137,11 +145,16 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **company_id** | **String** |  |  |
+| **company_id** | **String** | Unique identifier for the Company |  |
+| **page** | **Integer** | Page number for pagination | [optional][default to 1] |
+| **limit** | **Integer** | Number of items per page | [optional][default to 20] |
+| **sort_by** | **String** | Field to sort by | [optional] |
+| **sort_order** | **String** | Sort order (ascending or descending) | [optional][default to &#39;desc&#39;] |
+| **search** | **String** | Search term to filter results | [optional] |
 
 ### Return type
 
-[**CompaniesCompanyIdAnalyticsAssetsGet200Response**](CompaniesCompanyIdAnalyticsAssetsGet200Response.md)
+[**ListCompaniesAnalyticsAssets200Response**](ListCompaniesAnalyticsAssets200Response.md)
 
 ### Authorization
 
@@ -153,11 +166,11 @@ end
 - **Accept**: application/json
 
 
-## companies_company_id_analytics_dashboard_get
+## list_companies_analytics_assets
 
-> <CompaniesCompanyIdAnalyticsAssetsGet200Response> companies_company_id_analytics_dashboard_get(company_id)
+> <ListCompaniesAnalyticsAssets200Response> list_companies_analytics_assets(company_id, opts)
 
-Get comprehensive dashboard analytics for seller dashboard     Includes all metrics needed for dashboard charts in one call     Query params: start_date, end_date, period (day/week/month/quarter)
+Get asset performance analytics.     Query params: start_date, end_date, limit, sort_by, include
 
 ### Examples
 
@@ -173,32 +186,39 @@ SparteraApiSdk.configure do |config|
 end
 
 api_instance = SparteraApiSdk::CompaniesApi.new
-company_id = 'company_id_example' # String | 
+company_id = 'company_id_example' # String | Unique identifier for the Company
+opts = {
+  page: 56, # Integer | Page number for pagination
+  limit: 56, # Integer | Number of items per page
+  sort_by: 'sort_by_example', # String | Field to sort by
+  sort_order: 'asc', # String | Sort order (ascending or descending)
+  search: 'search_example' # String | Search term to filter results
+}
 
 begin
-  # Get comprehensive dashboard analytics for seller dashboard     Includes all metrics needed for dashboard charts in one call     Query params: start_date, end_date, period (day/week/month/quarter)
-  result = api_instance.companies_company_id_analytics_dashboard_get(company_id)
+  # Get asset performance analytics.     Query params: start_date, end_date, limit, sort_by, include
+  result = api_instance.list_companies_analytics_assets(company_id, opts)
   p result
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_analytics_dashboard_get: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_analytics_assets: #{e}"
 end
 ```
 
-#### Using the companies_company_id_analytics_dashboard_get_with_http_info variant
+#### Using the list_companies_analytics_assets_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<CompaniesCompanyIdAnalyticsAssetsGet200Response>, Integer, Hash)> companies_company_id_analytics_dashboard_get_with_http_info(company_id)
+> <Array(<ListCompaniesAnalyticsAssets200Response>, Integer, Hash)> list_companies_analytics_assets_with_http_info(company_id, opts)
 
 ```ruby
 begin
-  # Get comprehensive dashboard analytics for seller dashboard     Includes all metrics needed for dashboard charts in one call     Query params: start_date, end_date, period (day/week/month/quarter)
-  data, status_code, headers = api_instance.companies_company_id_analytics_dashboard_get_with_http_info(company_id)
+  # Get asset performance analytics.     Query params: start_date, end_date, limit, sort_by, include
+  data, status_code, headers = api_instance.list_companies_analytics_assets_with_http_info(company_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <CompaniesCompanyIdAnalyticsAssetsGet200Response>
+  p data # => <ListCompaniesAnalyticsAssets200Response>
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_analytics_dashboard_get_with_http_info: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_analytics_assets_with_http_info: #{e}"
 end
 ```
 
@@ -206,11 +226,16 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **company_id** | **String** |  |  |
+| **company_id** | **String** | Unique identifier for the Company |  |
+| **page** | **Integer** | Page number for pagination | [optional][default to 1] |
+| **limit** | **Integer** | Number of items per page | [optional][default to 20] |
+| **sort_by** | **String** | Field to sort by | [optional] |
+| **sort_order** | **String** | Sort order (ascending or descending) | [optional][default to &#39;desc&#39;] |
+| **search** | **String** | Search term to filter results | [optional] |
 
 ### Return type
 
-[**CompaniesCompanyIdAnalyticsAssetsGet200Response**](CompaniesCompanyIdAnalyticsAssetsGet200Response.md)
+[**ListCompaniesAnalyticsAssets200Response**](ListCompaniesAnalyticsAssets200Response.md)
 
 ### Authorization
 
@@ -222,11 +247,11 @@ end
 - **Accept**: application/json
 
 
-## companies_company_id_analytics_sales_get
+## list_companies_analytics_customers
 
-> <CompaniesCompanyIdAnalyticsAssetsGet200Response> companies_company_id_analytics_sales_get(company_id)
+> <ListCompaniesAnalyticsAssets200Response> list_companies_analytics_customers(company_id, opts)
 
-Get sales over time analytics     Query params: start_date, end_date, group_by (day/week/month/quarter), metrics
+Get customer analytics including growth and segmentation.     Query params: start_date, end_date, group_by, segment_by
 
 ### Examples
 
@@ -242,32 +267,39 @@ SparteraApiSdk.configure do |config|
 end
 
 api_instance = SparteraApiSdk::CompaniesApi.new
-company_id = 'company_id_example' # String | 
+company_id = 'company_id_example' # String | Unique identifier for the Company
+opts = {
+  page: 56, # Integer | Page number for pagination
+  limit: 56, # Integer | Number of items per page
+  sort_by: 'sort_by_example', # String | Field to sort by
+  sort_order: 'asc', # String | Sort order (ascending or descending)
+  search: 'search_example' # String | Search term to filter results
+}
 
 begin
-  # Get sales over time analytics     Query params: start_date, end_date, group_by (day/week/month/quarter), metrics
-  result = api_instance.companies_company_id_analytics_sales_get(company_id)
+  # Get customer analytics including growth and segmentation.     Query params: start_date, end_date, group_by, segment_by
+  result = api_instance.list_companies_analytics_customers(company_id, opts)
   p result
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_analytics_sales_get: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_analytics_customers: #{e}"
 end
 ```
 
-#### Using the companies_company_id_analytics_sales_get_with_http_info variant
+#### Using the list_companies_analytics_customers_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<CompaniesCompanyIdAnalyticsAssetsGet200Response>, Integer, Hash)> companies_company_id_analytics_sales_get_with_http_info(company_id)
+> <Array(<ListCompaniesAnalyticsAssets200Response>, Integer, Hash)> list_companies_analytics_customers_with_http_info(company_id, opts)
 
 ```ruby
 begin
-  # Get sales over time analytics     Query params: start_date, end_date, group_by (day/week/month/quarter), metrics
-  data, status_code, headers = api_instance.companies_company_id_analytics_sales_get_with_http_info(company_id)
+  # Get customer analytics including growth and segmentation.     Query params: start_date, end_date, group_by, segment_by
+  data, status_code, headers = api_instance.list_companies_analytics_customers_with_http_info(company_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <CompaniesCompanyIdAnalyticsAssetsGet200Response>
+  p data # => <ListCompaniesAnalyticsAssets200Response>
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_analytics_sales_get_with_http_info: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_analytics_customers_with_http_info: #{e}"
 end
 ```
 
@@ -275,11 +307,16 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **company_id** | **String** |  |  |
+| **company_id** | **String** | Unique identifier for the Company |  |
+| **page** | **Integer** | Page number for pagination | [optional][default to 1] |
+| **limit** | **Integer** | Number of items per page | [optional][default to 20] |
+| **sort_by** | **String** | Field to sort by | [optional] |
+| **sort_order** | **String** | Sort order (ascending or descending) | [optional][default to &#39;desc&#39;] |
+| **search** | **String** | Search term to filter results | [optional] |
 
 ### Return type
 
-[**CompaniesCompanyIdAnalyticsAssetsGet200Response**](CompaniesCompanyIdAnalyticsAssetsGet200Response.md)
+[**ListCompaniesAnalyticsAssets200Response**](ListCompaniesAnalyticsAssets200Response.md)
 
 ### Authorization
 
@@ -291,11 +328,11 @@ end
 - **Accept**: application/json
 
 
-## companies_company_id_get
+## list_companies_analytics_dashboard
 
-> <CompaniesCompanyIdGet200Response> companies_company_id_get(company_id)
+> <ListCompaniesAnalyticsAssets200Response> list_companies_analytics_dashboard(company_id, opts)
 
-Get details of the requestor's own company
+Get comprehensive dashboard analytics for seller dashboard.     Query params: start_date, end_date, period (day/week/month/quarter)
 
 ### Examples
 
@@ -311,32 +348,39 @@ SparteraApiSdk.configure do |config|
 end
 
 api_instance = SparteraApiSdk::CompaniesApi.new
-company_id = 'company_id_example' # String | 
+company_id = 'company_id_example' # String | Unique identifier for the Company
+opts = {
+  page: 56, # Integer | Page number for pagination
+  limit: 56, # Integer | Number of items per page
+  sort_by: 'sort_by_example', # String | Field to sort by
+  sort_order: 'asc', # String | Sort order (ascending or descending)
+  search: 'search_example' # String | Search term to filter results
+}
 
 begin
-  # Get details of the requestor's own company
-  result = api_instance.companies_company_id_get(company_id)
+  # Get comprehensive dashboard analytics for seller dashboard.     Query params: start_date, end_date, period (day/week/month/quarter)
+  result = api_instance.list_companies_analytics_dashboard(company_id, opts)
   p result
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_get: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_analytics_dashboard: #{e}"
 end
 ```
 
-#### Using the companies_company_id_get_with_http_info variant
+#### Using the list_companies_analytics_dashboard_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<CompaniesCompanyIdGet200Response>, Integer, Hash)> companies_company_id_get_with_http_info(company_id)
+> <Array(<ListCompaniesAnalyticsAssets200Response>, Integer, Hash)> list_companies_analytics_dashboard_with_http_info(company_id, opts)
 
 ```ruby
 begin
-  # Get details of the requestor's own company
-  data, status_code, headers = api_instance.companies_company_id_get_with_http_info(company_id)
+  # Get comprehensive dashboard analytics for seller dashboard.     Query params: start_date, end_date, period (day/week/month/quarter)
+  data, status_code, headers = api_instance.list_companies_analytics_dashboard_with_http_info(company_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <CompaniesCompanyIdGet200Response>
+  p data # => <ListCompaniesAnalyticsAssets200Response>
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_get_with_http_info: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_analytics_dashboard_with_http_info: #{e}"
 end
 ```
 
@@ -344,11 +388,16 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **company_id** | **String** |  |  |
+| **company_id** | **String** | Unique identifier for the Company |  |
+| **page** | **Integer** | Page number for pagination | [optional][default to 1] |
+| **limit** | **Integer** | Number of items per page | [optional][default to 20] |
+| **sort_by** | **String** | Field to sort by | [optional] |
+| **sort_order** | **String** | Sort order (ascending or descending) | [optional][default to &#39;desc&#39;] |
+| **search** | **String** | Search term to filter results | [optional] |
 
 ### Return type
 
-[**CompaniesCompanyIdGet200Response**](CompaniesCompanyIdGet200Response.md)
+[**ListCompaniesAnalyticsAssets200Response**](ListCompaniesAnalyticsAssets200Response.md)
 
 ### Authorization
 
@@ -360,11 +409,11 @@ end
 - **Accept**: application/json
 
 
-## companies_company_id_objects_get
+## list_companies_analytics_metrics
 
-> <CompaniesCompanyIdAnalyticsAssetsGet200Response> companies_company_id_objects_get(company_id)
+> <ListCompaniesAnalyticsAssets200Response> list_companies_analytics_metrics(company_id, opts)
 
-Get all objects (connections, assets) of a single company
+Get summary metrics (counts only). No date params needed — returns all-time totals.     Performance: < 0.1s
 
 ### Examples
 
@@ -380,32 +429,39 @@ SparteraApiSdk.configure do |config|
 end
 
 api_instance = SparteraApiSdk::CompaniesApi.new
-company_id = 'company_id_example' # String | 
+company_id = 'company_id_example' # String | Unique identifier for the Company
+opts = {
+  page: 56, # Integer | Page number for pagination
+  limit: 56, # Integer | Number of items per page
+  sort_by: 'sort_by_example', # String | Field to sort by
+  sort_order: 'asc', # String | Sort order (ascending or descending)
+  search: 'search_example' # String | Search term to filter results
+}
 
 begin
-  # Get all objects (connections, assets) of a single company
-  result = api_instance.companies_company_id_objects_get(company_id)
+  # Get summary metrics (counts only). No date params needed — returns all-time totals.     Performance: < 0.1s
+  result = api_instance.list_companies_analytics_metrics(company_id, opts)
   p result
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_objects_get: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_analytics_metrics: #{e}"
 end
 ```
 
-#### Using the companies_company_id_objects_get_with_http_info variant
+#### Using the list_companies_analytics_metrics_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<CompaniesCompanyIdAnalyticsAssetsGet200Response>, Integer, Hash)> companies_company_id_objects_get_with_http_info(company_id)
+> <Array(<ListCompaniesAnalyticsAssets200Response>, Integer, Hash)> list_companies_analytics_metrics_with_http_info(company_id, opts)
 
 ```ruby
 begin
-  # Get all objects (connections, assets) of a single company
-  data, status_code, headers = api_instance.companies_company_id_objects_get_with_http_info(company_id)
+  # Get summary metrics (counts only). No date params needed — returns all-time totals.     Performance: < 0.1s
+  data, status_code, headers = api_instance.list_companies_analytics_metrics_with_http_info(company_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <CompaniesCompanyIdAnalyticsAssetsGet200Response>
+  p data # => <ListCompaniesAnalyticsAssets200Response>
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_objects_get_with_http_info: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_analytics_metrics_with_http_info: #{e}"
 end
 ```
 
@@ -413,11 +469,16 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **company_id** | **String** |  |  |
+| **company_id** | **String** | Unique identifier for the Company |  |
+| **page** | **Integer** | Page number for pagination | [optional][default to 1] |
+| **limit** | **Integer** | Number of items per page | [optional][default to 20] |
+| **sort_by** | **String** | Field to sort by | [optional] |
+| **sort_order** | **String** | Sort order (ascending or descending) | [optional][default to &#39;desc&#39;] |
+| **search** | **String** | Search term to filter results | [optional] |
 
 ### Return type
 
-[**CompaniesCompanyIdAnalyticsAssetsGet200Response**](CompaniesCompanyIdAnalyticsAssetsGet200Response.md)
+[**ListCompaniesAnalyticsAssets200Response**](ListCompaniesAnalyticsAssets200Response.md)
 
 ### Authorization
 
@@ -429,11 +490,11 @@ end
 - **Accept**: application/json
 
 
-## companies_company_id_patch
+## list_companies_analytics_sales
 
-> <CompaniesCompanyIdPatch200Response> companies_company_id_patch(company_id, companies_update)
+> <ListCompaniesAnalyticsAssets200Response> list_companies_analytics_sales(company_id, opts)
 
-Update an existing company by ID
+Get sales over time analytics.     Query params: start_date, end_date, group_by (day/week/month/quarter), metrics
 
 ### Examples
 
@@ -449,33 +510,39 @@ SparteraApiSdk.configure do |config|
 end
 
 api_instance = SparteraApiSdk::CompaniesApi.new
-company_id = 'company_id_example' # String | 
-companies_update = SparteraApiSdk::CompaniesUpdate.new # CompaniesUpdate | 
+company_id = 'company_id_example' # String | Unique identifier for the Company
+opts = {
+  page: 56, # Integer | Page number for pagination
+  limit: 56, # Integer | Number of items per page
+  sort_by: 'sort_by_example', # String | Field to sort by
+  sort_order: 'asc', # String | Sort order (ascending or descending)
+  search: 'search_example' # String | Search term to filter results
+}
 
 begin
-  # Update an existing company by ID
-  result = api_instance.companies_company_id_patch(company_id, companies_update)
+  # Get sales over time analytics.     Query params: start_date, end_date, group_by (day/week/month/quarter), metrics
+  result = api_instance.list_companies_analytics_sales(company_id, opts)
   p result
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_patch: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_analytics_sales: #{e}"
 end
 ```
 
-#### Using the companies_company_id_patch_with_http_info variant
+#### Using the list_companies_analytics_sales_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<CompaniesCompanyIdPatch200Response>, Integer, Hash)> companies_company_id_patch_with_http_info(company_id, companies_update)
+> <Array(<ListCompaniesAnalyticsAssets200Response>, Integer, Hash)> list_companies_analytics_sales_with_http_info(company_id, opts)
 
 ```ruby
 begin
-  # Update an existing company by ID
-  data, status_code, headers = api_instance.companies_company_id_patch_with_http_info(company_id, companies_update)
+  # Get sales over time analytics.     Query params: start_date, end_date, group_by (day/week/month/quarter), metrics
+  data, status_code, headers = api_instance.list_companies_analytics_sales_with_http_info(company_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <CompaniesCompanyIdPatch200Response>
+  p data # => <ListCompaniesAnalyticsAssets200Response>
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_patch_with_http_info: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_analytics_sales_with_http_info: #{e}"
 end
 ```
 
@@ -483,12 +550,16 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **company_id** | **String** |  |  |
-| **companies_update** | [**CompaniesUpdate**](CompaniesUpdate.md) |  |  |
+| **company_id** | **String** | Unique identifier for the Company |  |
+| **page** | **Integer** | Page number for pagination | [optional][default to 1] |
+| **limit** | **Integer** | Number of items per page | [optional][default to 20] |
+| **sort_by** | **String** | Field to sort by | [optional] |
+| **sort_order** | **String** | Sort order (ascending or descending) | [optional][default to &#39;desc&#39;] |
+| **search** | **String** | Search term to filter results | [optional] |
 
 ### Return type
 
-[**CompaniesCompanyIdPatch200Response**](CompaniesCompanyIdPatch200Response.md)
+[**ListCompaniesAnalyticsAssets200Response**](ListCompaniesAnalyticsAssets200Response.md)
 
 ### Authorization
 
@@ -496,15 +567,15 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: application/json
+- **Content-Type**: Not defined
 - **Accept**: application/json
 
 
-## companies_company_id_requests_plan_get
+## list_companies_objects
 
-> <CompaniesCompanyIdAnalyticsAssetsGet200Response> companies_company_id_requests_plan_get(company_id)
+> <ListCompaniesAnalyticsAssets200Response> list_companies_objects(company_id, opts)
 
-Get the total number of requests allocated in the company's current subscription plan.
+Get all objects (connections, assets) of a single company
 
 ### Examples
 
@@ -520,32 +591,39 @@ SparteraApiSdk.configure do |config|
 end
 
 api_instance = SparteraApiSdk::CompaniesApi.new
-company_id = 'company_id_example' # String | 
+company_id = 'company_id_example' # String | Unique identifier for the Company
+opts = {
+  page: 56, # Integer | Page number for pagination
+  limit: 56, # Integer | Number of items per page
+  sort_by: 'sort_by_example', # String | Field to sort by
+  sort_order: 'asc', # String | Sort order (ascending or descending)
+  search: 'search_example' # String | Search term to filter results
+}
 
 begin
-  # Get the total number of requests allocated in the company's current subscription plan.
-  result = api_instance.companies_company_id_requests_plan_get(company_id)
+  # Get all objects (connections, assets) of a single company
+  result = api_instance.list_companies_objects(company_id, opts)
   p result
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_requests_plan_get: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_objects: #{e}"
 end
 ```
 
-#### Using the companies_company_id_requests_plan_get_with_http_info variant
+#### Using the list_companies_objects_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<CompaniesCompanyIdAnalyticsAssetsGet200Response>, Integer, Hash)> companies_company_id_requests_plan_get_with_http_info(company_id)
+> <Array(<ListCompaniesAnalyticsAssets200Response>, Integer, Hash)> list_companies_objects_with_http_info(company_id, opts)
 
 ```ruby
 begin
-  # Get the total number of requests allocated in the company's current subscription plan.
-  data, status_code, headers = api_instance.companies_company_id_requests_plan_get_with_http_info(company_id)
+  # Get all objects (connections, assets) of a single company
+  data, status_code, headers = api_instance.list_companies_objects_with_http_info(company_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <CompaniesCompanyIdAnalyticsAssetsGet200Response>
+  p data # => <ListCompaniesAnalyticsAssets200Response>
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_requests_plan_get_with_http_info: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_objects_with_http_info: #{e}"
 end
 ```
 
@@ -553,11 +631,16 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **company_id** | **String** |  |  |
+| **company_id** | **String** | Unique identifier for the Company |  |
+| **page** | **Integer** | Page number for pagination | [optional][default to 1] |
+| **limit** | **Integer** | Number of items per page | [optional][default to 20] |
+| **sort_by** | **String** | Field to sort by | [optional] |
+| **sort_order** | **String** | Sort order (ascending or descending) | [optional][default to &#39;desc&#39;] |
+| **search** | **String** | Search term to filter results | [optional] |
 
 ### Return type
 
-[**CompaniesCompanyIdAnalyticsAssetsGet200Response**](CompaniesCompanyIdAnalyticsAssetsGet200Response.md)
+[**ListCompaniesAnalyticsAssets200Response**](ListCompaniesAnalyticsAssets200Response.md)
 
 ### Authorization
 
@@ -569,11 +652,11 @@ end
 - **Accept**: application/json
 
 
-## companies_company_id_requests_usage_get
+## list_companies_requests_usage
 
-> <CompaniesCompanyIdAnalyticsAssetsGet200Response> companies_company_id_requests_usage_get(company_id)
+> <ListCompaniesAnalyticsAssets200Response> list_companies_requests_usage(company_id, opts)
 
-Get company request usage data for a specific month. Returns JSON metrics by default or CSV logs when download parameter is included.
+Get company request usage data for a specific month.
 
 ### Examples
 
@@ -589,32 +672,39 @@ SparteraApiSdk.configure do |config|
 end
 
 api_instance = SparteraApiSdk::CompaniesApi.new
-company_id = 'company_id_example' # String | 
+company_id = 'company_id_example' # String | Unique identifier for the Company
+opts = {
+  page: 56, # Integer | Page number for pagination
+  limit: 56, # Integer | Number of items per page
+  sort_by: 'sort_by_example', # String | Field to sort by
+  sort_order: 'asc', # String | Sort order (ascending or descending)
+  search: 'search_example' # String | Search term to filter results
+}
 
 begin
-  # Get company request usage data for a specific month. Returns JSON metrics by default or CSV logs when download parameter is included.
-  result = api_instance.companies_company_id_requests_usage_get(company_id)
+  # Get company request usage data for a specific month.
+  result = api_instance.list_companies_requests_usage(company_id, opts)
   p result
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_requests_usage_get: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_requests_usage: #{e}"
 end
 ```
 
-#### Using the companies_company_id_requests_usage_get_with_http_info variant
+#### Using the list_companies_requests_usage_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<CompaniesCompanyIdAnalyticsAssetsGet200Response>, Integer, Hash)> companies_company_id_requests_usage_get_with_http_info(company_id)
+> <Array(<ListCompaniesAnalyticsAssets200Response>, Integer, Hash)> list_companies_requests_usage_with_http_info(company_id, opts)
 
 ```ruby
 begin
-  # Get company request usage data for a specific month. Returns JSON metrics by default or CSV logs when download parameter is included.
-  data, status_code, headers = api_instance.companies_company_id_requests_usage_get_with_http_info(company_id)
+  # Get company request usage data for a specific month.
+  data, status_code, headers = api_instance.list_companies_requests_usage_with_http_info(company_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <CompaniesCompanyIdAnalyticsAssetsGet200Response>
+  p data # => <ListCompaniesAnalyticsAssets200Response>
 rescue SparteraApiSdk::ApiError => e
-  puts "Error when calling CompaniesApi->companies_company_id_requests_usage_get_with_http_info: #{e}"
+  puts "Error when calling CompaniesApi->list_companies_requests_usage_with_http_info: #{e}"
 end
 ```
 
@@ -622,11 +712,16 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **company_id** | **String** |  |  |
+| **company_id** | **String** | Unique identifier for the Company |  |
+| **page** | **Integer** | Page number for pagination | [optional][default to 1] |
+| **limit** | **Integer** | Number of items per page | [optional][default to 20] |
+| **sort_by** | **String** | Field to sort by | [optional] |
+| **sort_order** | **String** | Sort order (ascending or descending) | [optional][default to &#39;desc&#39;] |
+| **search** | **String** | Search term to filter results | [optional] |
 
 ### Return type
 
-[**CompaniesCompanyIdAnalyticsAssetsGet200Response**](CompaniesCompanyIdAnalyticsAssetsGet200Response.md)
+[**ListCompaniesAnalyticsAssets200Response**](ListCompaniesAnalyticsAssets200Response.md)
 
 ### Authorization
 
@@ -637,3 +732,74 @@ end
 - **Content-Type**: Not defined
 - **Accept**: application/json
 
+
+## update_companies
+
+> <UpdateCompanies200Response> update_companies(company_id, companies_update)
+
+Update an existing company by ID
+
+### 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::CompaniesApi.new
+company_id = 'company_id_example' # String | Unique identifier for the Company
+companies_update = SparteraApiSdk::CompaniesUpdate.new # CompaniesUpdate | 
+
+begin
+  # Update an existing company by ID
+  result = api_instance.update_companies(company_id, companies_update)
+  p result
+rescue SparteraApiSdk::ApiError => e
+  puts "Error when calling CompaniesApi->update_companies: #{e}"
+end
+```
+
+#### Using the update_companies_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<UpdateCompanies200Response>, Integer, Hash)> update_companies_with_http_info(company_id, companies_update)
+
+```ruby
+begin
+  # Update an existing company by ID
+  data, status_code, headers = api_instance.update_companies_with_http_info(company_id, companies_update)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <UpdateCompanies200Response>
+rescue SparteraApiSdk::ApiError => e
+  puts "Error when calling CompaniesApi->update_companies_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **company_id** | **String** | Unique identifier for the Company |  |
+| **companies_update** | [**CompaniesUpdate**](CompaniesUpdate.md) |  |  |
+
+### Return type
+
+[**UpdateCompanies200Response**](UpdateCompanies200Response.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+