Update Python SDK (#101)

[bot](2025-12-09 12:07:33) Sync SDK with OpenAPI spec

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: vulncheck-oss-release-bot[bot]

.openapi-generator/FILES

@@ -847,6 +847,7 @@ docs/PaginateParam.md
 docs/ParamsIndexBackup.md
 docs/ParamsIndexBackupList.md
 docs/ParamsIndexList.md
+docs/PurlBatchVulnFinding.md
 docs/PurlPackageURLJSON.md
 docs/PurlQualifierJSON.md
 docs/PurlsPurlResponse.md
@@ -1312,9 +1313,11 @@ docs/RenderResponseWithMetadataArrayPurlsPurlResponsePaginatePagination.md
 docs/RenderResponseWithMetadataArrayStringV3controllersResponseMetadata.md
 docs/RenderResponseWithMetadataV3controllersBackupResponseDataV3controllersBackupResponseMetadata.md
 docs/RenderResponseWithMetadataV3controllersPurlResponseDataV3controllersPurlResponseMetadata.md
+docs/RenderResponseWithMetadataV3controllersPurlsResponseDataV3controllersPurlsResponseMetadata.md
 docs/V3controllersBackupResponseMetadata.md
 docs/V3controllersPurlResponseData.md
 docs/V3controllersPurlResponseMetadata.md
+docs/V3controllersPurlsResponseMetadata.md
 docs/V3controllersResponseMetadata.md
 pyproject.toml
 requirements.txt
@@ -2170,6 +2173,7 @@ test/test_paginate_param.py
 test/test_params_index_backup.py
 test/test_params_index_backup_list.py
 test/test_params_index_list.py
+test/test_purl_batch_vuln_finding.py
 test/test_purl_package_urljson.py
 test/test_purl_qualifier_json.py
 test/test_purls_purl_response.py
@@ -2635,9 +2639,11 @@ test/test_render_response_with_metadata_array_purls_purl_response_paginate_pagin
 test/test_render_response_with_metadata_array_string_v3controllers_response_metadata.py
 test/test_render_response_with_metadata_v3controllers_backup_response_data_v3controllers_backup_response_metadata.py
 test/test_render_response_with_metadata_v3controllers_purl_response_data_v3controllers_purl_response_metadata.py
+test/test_render_response_with_metadata_v3controllers_purls_response_data_v3controllers_purls_response_metadata.py
 test/test_v3controllers_backup_response_metadata.py
 test/test_v3controllers_purl_response_data.py
 test/test_v3controllers_purl_response_metadata.py
+test/test_v3controllers_purls_response_metadata.py
 test/test_v3controllers_response_metadata.py
 vulncheck_sdk/__init__.py
 vulncheck_sdk/api/__init__.py
@@ -3494,6 +3500,7 @@ vulncheck_sdk/models/paginate_param.py
 vulncheck_sdk/models/params_index_backup.py
 vulncheck_sdk/models/params_index_backup_list.py
 vulncheck_sdk/models/params_index_list.py
+vulncheck_sdk/models/purl_batch_vuln_finding.py
 vulncheck_sdk/models/purl_package_urljson.py
 vulncheck_sdk/models/purl_qualifier_json.py
 vulncheck_sdk/models/purls_purl_response.py
@@ -3959,9 +3966,11 @@ vulncheck_sdk/models/render_response_with_metadata_array_purls_purl_response_pag
 vulncheck_sdk/models/render_response_with_metadata_array_string_v3controllers_response_metadata.py
 vulncheck_sdk/models/render_response_with_metadata_v3controllers_backup_response_data_v3controllers_backup_response_metadata.py
 vulncheck_sdk/models/render_response_with_metadata_v3controllers_purl_response_data_v3controllers_purl_response_metadata.py
+vulncheck_sdk/models/render_response_with_metadata_v3controllers_purls_response_data_v3controllers_purls_response_metadata.py
 vulncheck_sdk/models/v3controllers_backup_response_metadata.py
 vulncheck_sdk/models/v3controllers_purl_response_data.py
 vulncheck_sdk/models/v3controllers_purl_response_metadata.py
+vulncheck_sdk/models/v3controllers_purls_response_metadata.py
 vulncheck_sdk/models/v3controllers_response_metadata.py
 vulncheck_sdk/py.typed
 vulncheck_sdk/rest.py

docs/AdvisoryAppleAdvisory.md

@@ -9,6 +9,7 @@ Name | Type | Description | Notes
 **cve** | **List[str]** |  | [optional] 
 **date_added** | **str** |  | [optional] 
 **name** | **str** |  | [optional] 
+**updated_at** | **str** |  | [optional] 
 **url** | **str** |  | [optional] 
 
 ## Example

docs/AdvisoryFortinetAdvisory.md

@@ -16,6 +16,7 @@ Name | Type | Description | Notes
 **solutions** | **List[str]** |  | [optional] 
 **summary** | **str** |  | [optional] 
 **title** | **str** |  | [optional] 
+**updated_at** | **str** |  | [optional] 
 
 ## Example
 

docs/EndpointsApi.md

@@ -12,6 +12,7 @@ Method | HTTP request | Description
 [**openapi_get**](EndpointsApi.md#openapi_get) | **GET** /openapi | Return OpenAPI specification
 [**pdns_vulncheck_c2_get**](EndpointsApi.md#pdns_vulncheck_c2_get) | **GET** /pdns/vulncheck-c2 | Retrieve a list of C2 Hostnames
 [**purl_get**](EndpointsApi.md#purl_get) | **GET** /purl | Request vulnerabilities related to a PURL
+[**purls_post**](EndpointsApi.md#purls_post) | **POST** /purls | Request vulnerabilities related to a list of PURLs
 [**rules_initial_access_type_get**](EndpointsApi.md#rules_initial_access_type_get) | **GET** /rules/initial-access/{type} | Retrieve set of initial-access detection rules
 [**tags_vulncheck_c2_get**](EndpointsApi.md#tags_vulncheck_c2_get) | **GET** /tags/vulncheck-c2 | Retrieve a list of C2 IP addresses
 
@@ -647,6 +648,87 @@ Name | Type | Description  | Notes
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
+# **purls_post**
+> RenderResponseWithMetadataV3controllersPurlsResponseDataV3controllersPurlsResponseMetadata purls_post(purls)
+
+Request vulnerabilities related to a list of PURLs
+
+Accepts a JSON array of PURLs in the request body and returns a list of vulnerabilities
+
+### Example
+
+* Api Key Authentication (Bearer):
+
+```python
+import vulncheck_sdk
+from vulncheck_sdk.models.render_response_with_metadata_v3controllers_purls_response_data_v3controllers_purls_response_metadata import RenderResponseWithMetadataV3controllersPurlsResponseDataV3controllersPurlsResponseMetadata
+from vulncheck_sdk.rest import ApiException
+from pprint import pprint
+
+# Defining the host is optional and defaults to /v3
+# See configuration.py for a list of all supported configuration parameters.
+configuration = vulncheck_sdk.Configuration(
+    host = "/v3"
+)
+
+# The client must configure the authentication and authorization parameters
+# in accordance with the API server security policy.
+# Examples for each auth method are provided below, use the example that
+# satisfies your auth use case.
+
+# Configure API key authorization: Bearer
+configuration.api_key['Bearer'] = os.environ["API_KEY"]
+
+# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
+# configuration.api_key_prefix['Bearer'] = 'Bearer'
+
+# Enter a context with an instance of the API client
+with vulncheck_sdk.ApiClient(configuration) as api_client:
+    # Create an instance of the API class
+    api_instance = vulncheck_sdk.EndpointsApi(api_client)
+    purls = ['purls_example'] # List[str] | PURL strings used to identify and locate software packages
+
+    try:
+        # Request vulnerabilities related to a list of PURLs
+        api_response = api_instance.purls_post(purls)
+        print("The response of EndpointsApi->purls_post:\n")
+        pprint(api_response)
+    except Exception as e:
+        print("Exception when calling EndpointsApi->purls_post: %s\n" % e)
+```
+
+
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **purls** | [**List[str]**](str.md)| PURL strings used to identify and locate software packages | 
+
+### Return type
+
+[**RenderResponseWithMetadataV3controllersPurlsResponseDataV3controllersPurlsResponseMetadata**](RenderResponseWithMetadataV3controllersPurlsResponseDataV3controllersPurlsResponseMetadata.md)
+
+### Authorization
+
+[Bearer](../README.md#Bearer)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+### HTTP response details
+
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | OK |  -  |
+**404** | Not Found |  -  |
+**500** | Internal Server Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
 # **rules_initial_access_type_get**
 > str rules_initial_access_type_get(type)
 

docs/PurlBatchVulnFinding.md

@@ -0,0 +1,33 @@
+# PurlBatchVulnFinding
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**cves** | **List[str]** | list of associated CVE 's | [optional] 
+**purl** | **str** | the purl, ex. hex/coherence@0.1.2 | [optional] 
+**purl_struct** | [**PurlPackageURLJSON**](PurlPackageURLJSON.md) | meta-data about the purl | [optional] 
+**research_attributes** | [**ApiOSSPackageResearchAttributes**](ApiOSSPackageResearchAttributes.md) |  | [optional] 
+**vulnerabilities** | [**List[ApiOSSPackageVulnerability]**](ApiOSSPackageVulnerability.md) | list of associated vulnerabilities | [optional] 
+
+## Example
+
+```python
+from vulncheck_sdk.models.purl_batch_vuln_finding import PurlBatchVulnFinding
+
+# TODO update the JSON string below
+json = "{}"
+# create an instance of PurlBatchVulnFinding from a JSON string
+purl_batch_vuln_finding_instance = PurlBatchVulnFinding.from_json(json)
+# print the JSON string representation of the object
+print(PurlBatchVulnFinding.to_json())
+
+# convert the object into a dict
+purl_batch_vuln_finding_dict = purl_batch_vuln_finding_instance.to_dict()
+# create an instance of PurlBatchVulnFinding from a dict
+purl_batch_vuln_finding_from_dict = PurlBatchVulnFinding.from_dict(purl_batch_vuln_finding_dict)
+```
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

docs/RenderResponseWithMetadataV3controllersPurlsResponseDataV3controllersPurlsResponseMetadata.md

@@ -0,0 +1,31 @@
+# RenderResponseWithMetadataV3controllersPurlsResponseDataV3controllersPurlsResponseMetadata
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**benchmark** | **float** |  | [optional] 
+**meta** | [**V3controllersPurlsResponseMetadata**](V3controllersPurlsResponseMetadata.md) |  | [optional] 
+**data** | [**List[PurlBatchVulnFinding]**](PurlBatchVulnFinding.md) |  | [optional] 
+
+## Example
+
+```python
+from vulncheck_sdk.models.render_response_with_metadata_v3controllers_purls_response_data_v3controllers_purls_response_metadata import RenderResponseWithMetadataV3controllersPurlsResponseDataV3controllersPurlsResponseMetadata
+
+# TODO update the JSON string below
+json = "{}"
+# create an instance of RenderResponseWithMetadataV3controllersPurlsResponseDataV3controllersPurlsResponseMetadata from a JSON string
+render_response_with_metadata_v3controllers_purls_response_data_v3controllers_purls_response_metadata_instance = RenderResponseWithMetadataV3controllersPurlsResponseDataV3controllersPurlsResponseMetadata.from_json(json)
+# print the JSON string representation of the object
+print(RenderResponseWithMetadataV3controllersPurlsResponseDataV3controllersPurlsResponseMetadata.to_json())
+
+# convert the object into a dict
+render_response_with_metadata_v3controllers_purls_response_data_v3controllers_purls_response_metadata_dict = render_response_with_metadata_v3controllers_purls_response_data_v3controllers_purls_response_metadata_instance.to_dict()
+# create an instance of RenderResponseWithMetadataV3controllersPurlsResponseDataV3controllersPurlsResponseMetadata from a dict
+render_response_with_metadata_v3controllers_purls_response_data_v3controllers_purls_response_metadata_from_dict = RenderResponseWithMetadataV3controllersPurlsResponseDataV3controllersPurlsResponseMetadata.from_dict(render_response_with_metadata_v3controllers_purls_response_data_v3controllers_purls_response_metadata_dict)
+```
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

docs/V3controllersPurlsResponseMetadata.md

@@ -0,0 +1,30 @@
+# V3controllersPurlsResponseMetadata
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**timestamp** | **str** | time of the transaction | [optional] 
+**total_documents** | **int** | number of results found | [optional] 
+
+## Example
+
+```python
+from vulncheck_sdk.models.v3controllers_purls_response_metadata import V3controllersPurlsResponseMetadata
+
+# TODO update the JSON string below
+json = "{}"
+# create an instance of V3controllersPurlsResponseMetadata from a JSON string
+v3controllers_purls_response_metadata_instance = V3controllersPurlsResponseMetadata.from_json(json)
+# print the JSON string representation of the object
+print(V3controllersPurlsResponseMetadata.to_json())
+
+# convert the object into a dict
+v3controllers_purls_response_metadata_dict = v3controllers_purls_response_metadata_instance.to_dict()
+# create an instance of V3controllersPurlsResponseMetadata from a dict
+v3controllers_purls_response_metadata_from_dict = V3controllersPurlsResponseMetadata.from_dict(v3controllers_purls_response_metadata_dict)
+```
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

openapi.json

@@ -1,6 +1,6 @@
 [project]
 name = "vulncheck_sdk"
-version = "0.0.34"
+version = "0.0.35"
 description = "VulnCheck API"
 authors = [
   {name = "VulnCheck API Support",email = "support@vulncheck.com"},

pyproject.toml

@@ -2,4 +2,4 @@ additionalProperties:
   projectName: "vulncheck-sdk"
   packageName: "vulncheck_sdk"
   packageUrl: "https://github.com/vulncheck-oss/sdk-python/tree/main"
-  packageVersion: "0.0.34"
+  packageVersion: "0.0.35"