mixpeek 0.17.4__tar.gz → 0.18.7__tar.gz

{mixpeek-0.17.4 → mixpeek-0.18.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mixpeek
-Version: 0.17.4
+Version: 0.18.7
 Summary: Python Client SDK Generated by Speakeasy.
 Author: Speakeasy
 Requires-Python: >=3.9
@@ -10,12 +10,12 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: eval-type-backport (>=0.2.0,<0.3.0)
-Requires-Dist: httpx (>=0.28.1,<0.29.0)
-Requires-Dist: jsonpath-python (>=1.0.6,<2.0.0)
-Requires-Dist: pydantic (>=2.10.3,<2.11.0)
-Requires-Dist: python-dateutil (>=2.8.2,<3.0.0)
-Requires-Dist: typing-inspect (>=0.9.0,<0.10.0)
+Requires-Dist: eval-type-backport (>=0.2.0)
+Requires-Dist: httpx (>=0.28.1)
+Requires-Dist: jsonpath-python (>=1.0.6)
+Requires-Dist: pydantic (>=2.10.3)
+Requires-Dist: python-dateutil (>=2.8.2)
+Requires-Dist: typing-inspect (>=0.9.0)
 Project-URL: Repository, https://github.com/mixpeek/python-sdk.git
 Description-Content-Type: text/markdown
 
@@ -42,6 +42,7 @@ Mixpeek API: This is the Mixpeek API, providing access to various endpoints for
   * [Error Handling](https://github.com/mixpeek/python-sdk/blob/master/#error-handling)
   * [Server Selection](https://github.com/mixpeek/python-sdk/blob/master/#server-selection)
   * [Custom HTTP Client](https://github.com/mixpeek/python-sdk/blob/master/#custom-http-client)
+  * [Resource Management](https://github.com/mixpeek/python-sdk/blob/master/#resource-management)
   * [Debugging](https://github.com/mixpeek/python-sdk/blob/master/#debugging)
 * [Development](https://github.com/mixpeek/python-sdk/blob/master/#development)
   * [Maturity](https://github.com/mixpeek/python-sdk/blob/master/#maturity)
@@ -52,6 +53,11 @@ Mixpeek API: This is the Mixpeek API, providing access to various endpoints for
 <!-- Start SDK Installation [installation] -->
 ## SDK Installation
 
+> [!NOTE]
+> **Python version upgrade policy**
+>
+> Once a Python version reaches its [official end of life date](https://devguide.python.org/versions/), a 3-month grace period is provided for users to upgrade. Following this grace period, the minimum python version supported in the SDK will be updated.
+
 The SDK can be installed with either *pip* or *poetry* package managers.
 
 ### PIP
@@ -160,36 +166,33 @@ with Mixpeek(
 
 ### [assets](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md)
 
-* [get_asset_v1_assets_asset_id_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#get_asset_v1_assets_asset_id_get) - Get Asset
-* [delete_asset_v1_assets_asset_id_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#delete_asset_v1_assets_asset_id_delete) - Delete Asset
-* [full_asset_update_v1_assets_asset_id_put](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#full_asset_update_v1_assets_asset_id_put) - Full Asset Update
-* [partial_asset_update_v1_assets_asset_id_patch](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#partial_asset_update_v1_assets_asset_id_patch) - Partial Asset Update
-* [get_asset_with_features_v1_assets_asset_id_features_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#get_asset_with_features_v1_assets_asset_id_features_get) - Get Asset With Features
-* [list_assets_v1_assets_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#list_assets_v1_assets_post) - List Assets
-* [search_assets_v1_assets_search_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#search_assets_v1_assets_search_post) - Search Assets
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#get) - Get Asset
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#delete) - Delete Asset
+* [update](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#update) - Full Asset Update
+* [partial_update](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#partial_update) - Partial Asset Update
+* [get_with_features](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#get_with_features) - Get Asset With Features
+* [list](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#list) - List Assets
+* [search](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#search) - Search Assets
 
 ### [collections](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md)
 
-* [list_collections_v1_collections_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#list_collections_v1_collections_get) - List Collections
-* [create_collection_v1_collections_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#create_collection_v1_collections_post) - Create Collection
-* [delete_collection_v1_collections_collection_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#delete_collection_v1_collections_collection_delete) - Delete Collection
-* [update_collection_v1_collections_collection_put](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#update_collection_v1_collections_collection_put) - Update Collection
-* [get_collection_v1_collections_collection_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#get_collection_v1_collections_collection_get) - Get Collection
+* [list](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#list) - List Collections
+* [create](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#create) - Create Collection
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#delete) - Delete Collection
+* [update](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#update) - Update Collection
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#get) - Get Collection
 
 ### [feature_extractors](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/featureextractors/README.md)
 
-* [extract_embeddings_v1_features_extractors_embed_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/featureextractors/README.md#extract_embeddings_v1_features_extractors_embed_post) - Extract Embeddings
-
-### [feature_search](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/featuresearch/README.md)
-
-* [search_features_v1_features_search_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/featuresearch/README.md#search_features_v1_features_search_post) - Search Features
+* [extract_embeddings](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/featureextractors/README.md#extract_embeddings) - Extract Embeddings
 
 ### [features](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md)
 
-* [get_feature_v1_features_feature_id_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#get_feature_v1_features_feature_id_get) - Get Feature
-* [delete_feature_v1_features_feature_id_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#delete_feature_v1_features_feature_id_delete) - Delete Feature
-* [full_feature_update_v1_features_feature_id_put](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#full_feature_update_v1_features_feature_id_put) - Full Feature Update
-* [list_features_v1_features_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#list_features_v1_features_post) - List Features
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#get) - Get Feature
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#delete) - Delete Feature
+* [update](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#update) - Full Feature Update
+* [list](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#list) - List Features
+* [search](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#search) - Search Features
 
 ### [health](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/health/README.md)
 
@@ -197,48 +200,55 @@ with Mixpeek(
 
 ### [ingest_assets](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md)
 
-* [ingest_text_v1_ingest_text_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md#ingest_text_v1_ingest_text_post) - Ingest Text
-* [ingest_video_url_v1_ingest_videos_url_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md#ingest_video_url_v1_ingest_videos_url_post) - Ingest Video Url
-* [ingest_image_url_v1_ingest_images_url_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md#ingest_image_url_v1_ingest_images_url_post) - Ingest Image Url
+* [ingest_text](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md#ingest_text) - Ingest Text
+* [ingest_video_url](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md#ingest_video_url) - Ingest Video Url
+* [ingest_image_url](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md#ingest_image_url) - Ingest Image Url
 
 
 ### [namespaces](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md)
 
-* [create_namespace_v1_namespaces_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#create_namespace_v1_namespaces_post) - Create Namespace
-* [list_namespaces_v1_namespaces_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#list_namespaces_v1_namespaces_get) - List Namespaces
-* [delete_namespace_v1_namespaces_namespace_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#delete_namespace_v1_namespaces_namespace_delete) - Delete Namespace
-* [update_namespace_v1_namespaces_namespace_put](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#update_namespace_v1_namespaces_namespace_put) - Update Namespace
-* [get_namespace_v1_namespaces_namespace_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#get_namespace_v1_namespaces_namespace_get) - Get Namespace
-* [list_available_models_v1_namespaces_models_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#list_available_models_v1_namespaces_models_get) - List Available Models
+* [create](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#create) - Create Namespace
+* [list](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#list) - List Namespaces
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#delete) - Delete Namespace
+* [update](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#update) - Update Namespace
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#get) - Get Namespace
+* [list_models](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#list_models) - List Available Models
 
 ### [organizations](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md)
 
-* [get_organization_v1_organizations_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#get_organization_v1_organizations_get) - Get Organization
-* [get_usage_v1_organizations_usage_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#get_usage_v1_organizations_usage_get) - Get Usage
-* [get_user_v1_organizations_users_user_email_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#get_user_v1_organizations_users_user_email_get) - Get User
-* [delete_user_v1_organizations_users_user_email_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#delete_user_v1_organizations_users_user_email_delete) - Delete User
-* [add_user_v1_organizations_users_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#add_user_v1_organizations_users_post) - Add User
-* [create_api_key_v1_organizations_users_user_email_api_keys_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#create_api_key_v1_organizations_users_user_email_api_keys_post) - Create Api Key
-* [delete_api_key_v1_organizations_users_user_email_api_keys_key_name_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#delete_api_key_v1_organizations_users_user_email_api_keys_key_name_delete) - Delete Api Key
-* [update_api_key_v1_organizations_users_user_email_api_keys_key_name_patch](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#update_api_key_v1_organizations_users_user_email_api_keys_key_name_patch) - Update Api Key
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#get) - Get Organization
+* [get_usage](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#get_usage) - Get Usage
+* [add_user](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#add_user) - Add User
+* [delete_api_key](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#delete_api_key) - Delete Api Key
+* [update_api_key](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#update_api_key) - Update Api Key
 
 ### [tasks](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/tasks/README.md)
 
-* [kill_task_v1_tasks_task_id_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/tasks/README.md#kill_task_v1_tasks_task_id_delete) - Kill Task
-* [get_task_v1_tasks_task_id_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/tasks/README.md#get_task_v1_tasks_task_id_get) - Get Task Information
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/tasks/README.md#delete) - Kill Task
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/tasks/README.md#get) - Get Task Information
+* [list_active](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/tasks/README.md#list_active) - List Active Tasks
+
+### [taxonomies](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomies/README.md)
+
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomies/README.md#get) - Get Taxonomy
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomies/README.md#delete) - Delete Taxonomy
+* [update](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomies/README.md#update) - Update Taxonomy
 
 ### [taxonomy_entities](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md)
 
-* [create_taxonomy_v1_entities_taxonomies_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#create_taxonomy_v1_entities_taxonomies_post) - Create Taxonomy
-* [list_taxonomies_v1_entities_taxonomies_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#list_taxonomies_v1_entities_taxonomies_get) - List Taxonomies
-* [get_taxonomy_v1_entities_taxonomies_taxonomy_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#get_taxonomy_v1_entities_taxonomies_taxonomy_get) - Get Taxonomy
-* [delete_taxonomy_v1_entities_taxonomies_taxonomy_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#delete_taxonomy_v1_entities_taxonomies_taxonomy_delete) - Delete Taxonomy
-* [update_taxonomy_v1_entities_taxonomies_taxonomy_patch](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#update_taxonomy_v1_entities_taxonomies_taxonomy_patch) - Update Taxonomy
-* [get_taxonomy_node_v1_entities_taxonomies_nodes_node_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#get_taxonomy_node_v1_entities_taxonomies_nodes_node_get) - Get Taxonomy Node
-* [update_node_v1_entities_taxonomies_nodes_node_patch](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#update_node_v1_entities_taxonomies_nodes_node_patch) - Update Node
-* [classify_features_v1_entities_taxonomies_taxonomy_classify_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#classify_features_v1_entities_taxonomies_taxonomy_classify_post) - Classify Features against Taxonomy
-* [list_classifications_v1_entities_taxonomies_taxonomy_classifications_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#list_classifications_v1_entities_taxonomies_taxonomy_classifications_post) - List Taxonomy Classifications
-* [delete_classifications_v1_entities_taxonomies_taxonomy_classifications_classification_id_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#delete_classifications_v1_entities_taxonomies_taxonomy_classifications_classification_id_delete) - Delete Classifications
+* [create](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#create) - Create Taxonomy
+* [list](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#list) - List Taxonomies
+* [get_node](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#get_node) - Get Taxonomy Node
+* [update_node](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#update_node) - Update Node
+* [classify_features](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#classify_features) - Classify Features against Taxonomy
+* [list_classifications](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#list_classifications) - List Taxonomy Classifications
+* [delete_classification](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#delete_classification) - Delete Classifications
+
+### [users](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/users/README.md)
+
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/users/README.md#get) - Get User
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/users/README.md#delete) - Delete User
+* [create_api_key](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/users/README.md#create_api_key) - Create Api Key
 
 </details>
 <!-- End Available Resources and Operations [operations] -->
@@ -299,7 +309,7 @@ By default, an API error will raise a models.APIError exception, which has the f
 | `.raw_response` | *httpx.Response* | The raw HTTP response |
 | `.body`         | *str*            | The response content  |
 
-When custom error responses are specified for an operation, the SDK may also raise their associated exceptions. You can refer to respective *Errors* tables in SDK docs for more details on possible exception types for each operation. For example, the `get_organization_v1_organizations_get_async` method may raise the following exceptions:
+When custom error responses are specified for an operation, the SDK may also raise their associated exceptions. You can refer to respective *Errors* tables in SDK docs for more details on possible exception types for each operation. For example, the `get_async` method may raise the following exceptions:
 
 | Error Type                 | Status Code        | Content Type     |
 | -------------------------- | ------------------ | ---------------- |
@@ -320,7 +330,7 @@ with Mixpeek(
     res = None
     try:
 
-        res = mixpeek.organizations.get_organization_v1_organizations_get()
+        res = mixpeek.organizations.get()
 
         # Handle response
         print(res)
@@ -444,6 +454,32 @@ s = Mixpeek(async_client=CustomClient(httpx.AsyncClient()))
 ```
 <!-- End Custom HTTP Client [http-client] -->
 
+<!-- Start Resource Management [resource-management] -->
+## Resource Management
+
+The `Mixpeek` class implements the context manager protocol and registers a finalizer function to close the underlying sync and async HTTPX clients it uses under the hood. This will close HTTP connections, release memory and free up other resources held by the SDK. In short-lived Python programs and notebooks that make a few SDK method calls, resource management may not be a concern. However, in longer-lived programs, it is beneficial to create a single SDK instance via a [context manager][context-manager] and reuse it across the application.
+
+[context-manager]: https://docs.python.org/3/reference/datamodel.html#context-managers
+
+```python
+from mixpeek import Mixpeek
+import os
+def main():
+    with Mixpeek(
+        token=os.getenv("MIXPEEK_TOKEN", ""),
+    ) as mixpeek:
+        # Rest of application here...
+
+
+# Or when using async:
+async def amain():
+    async with Mixpeek(
+        token=os.getenv("MIXPEEK_TOKEN", ""),
+    ) as mixpeek:
+        # Rest of application here...
+```
+<!-- End Resource Management [resource-management] -->
+
 <!-- Start Debugging [debug] -->
 ## Debugging
 

{mixpeek-0.17.4 → mixpeek-0.18.7}/README-PYPI.md

@@ -21,6 +21,7 @@ Mixpeek API: This is the Mixpeek API, providing access to various endpoints for
   * [Error Handling](https://github.com/mixpeek/python-sdk/blob/master/#error-handling)
   * [Server Selection](https://github.com/mixpeek/python-sdk/blob/master/#server-selection)
   * [Custom HTTP Client](https://github.com/mixpeek/python-sdk/blob/master/#custom-http-client)
+  * [Resource Management](https://github.com/mixpeek/python-sdk/blob/master/#resource-management)
   * [Debugging](https://github.com/mixpeek/python-sdk/blob/master/#debugging)
 * [Development](https://github.com/mixpeek/python-sdk/blob/master/#development)
   * [Maturity](https://github.com/mixpeek/python-sdk/blob/master/#maturity)
@@ -31,6 +32,11 @@ Mixpeek API: This is the Mixpeek API, providing access to various endpoints for
 <!-- Start SDK Installation [installation] -->
 ## SDK Installation
 
+> [!NOTE]
+> **Python version upgrade policy**
+>
+> Once a Python version reaches its [official end of life date](https://devguide.python.org/versions/), a 3-month grace period is provided for users to upgrade. Following this grace period, the minimum python version supported in the SDK will be updated.
+
 The SDK can be installed with either *pip* or *poetry* package managers.
 
 ### PIP
@@ -139,36 +145,33 @@ with Mixpeek(
 
 ### [assets](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md)
 
-* [get_asset_v1_assets_asset_id_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#get_asset_v1_assets_asset_id_get) - Get Asset
-* [delete_asset_v1_assets_asset_id_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#delete_asset_v1_assets_asset_id_delete) - Delete Asset
-* [full_asset_update_v1_assets_asset_id_put](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#full_asset_update_v1_assets_asset_id_put) - Full Asset Update
-* [partial_asset_update_v1_assets_asset_id_patch](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#partial_asset_update_v1_assets_asset_id_patch) - Partial Asset Update
-* [get_asset_with_features_v1_assets_asset_id_features_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#get_asset_with_features_v1_assets_asset_id_features_get) - Get Asset With Features
-* [list_assets_v1_assets_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#list_assets_v1_assets_post) - List Assets
-* [search_assets_v1_assets_search_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#search_assets_v1_assets_search_post) - Search Assets
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#get) - Get Asset
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#delete) - Delete Asset
+* [update](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#update) - Full Asset Update
+* [partial_update](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#partial_update) - Partial Asset Update
+* [get_with_features](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#get_with_features) - Get Asset With Features
+* [list](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#list) - List Assets
+* [search](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/assets/README.md#search) - Search Assets
 
 ### [collections](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md)
 
-* [list_collections_v1_collections_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#list_collections_v1_collections_get) - List Collections
-* [create_collection_v1_collections_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#create_collection_v1_collections_post) - Create Collection
-* [delete_collection_v1_collections_collection_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#delete_collection_v1_collections_collection_delete) - Delete Collection
-* [update_collection_v1_collections_collection_put](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#update_collection_v1_collections_collection_put) - Update Collection
-* [get_collection_v1_collections_collection_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#get_collection_v1_collections_collection_get) - Get Collection
+* [list](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#list) - List Collections
+* [create](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#create) - Create Collection
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#delete) - Delete Collection
+* [update](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#update) - Update Collection
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/collections/README.md#get) - Get Collection
 
 ### [feature_extractors](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/featureextractors/README.md)
 
-* [extract_embeddings_v1_features_extractors_embed_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/featureextractors/README.md#extract_embeddings_v1_features_extractors_embed_post) - Extract Embeddings
-
-### [feature_search](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/featuresearch/README.md)
-
-* [search_features_v1_features_search_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/featuresearch/README.md#search_features_v1_features_search_post) - Search Features
+* [extract_embeddings](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/featureextractors/README.md#extract_embeddings) - Extract Embeddings
 
 ### [features](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md)
 
-* [get_feature_v1_features_feature_id_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#get_feature_v1_features_feature_id_get) - Get Feature
-* [delete_feature_v1_features_feature_id_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#delete_feature_v1_features_feature_id_delete) - Delete Feature
-* [full_feature_update_v1_features_feature_id_put](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#full_feature_update_v1_features_feature_id_put) - Full Feature Update
-* [list_features_v1_features_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#list_features_v1_features_post) - List Features
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#get) - Get Feature
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#delete) - Delete Feature
+* [update](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#update) - Full Feature Update
+* [list](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#list) - List Features
+* [search](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/features/README.md#search) - Search Features
 
 ### [health](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/health/README.md)
 
@@ -176,48 +179,55 @@ with Mixpeek(
 
 ### [ingest_assets](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md)
 
-* [ingest_text_v1_ingest_text_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md#ingest_text_v1_ingest_text_post) - Ingest Text
-* [ingest_video_url_v1_ingest_videos_url_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md#ingest_video_url_v1_ingest_videos_url_post) - Ingest Video Url
-* [ingest_image_url_v1_ingest_images_url_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md#ingest_image_url_v1_ingest_images_url_post) - Ingest Image Url
+* [ingest_text](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md#ingest_text) - Ingest Text
+* [ingest_video_url](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md#ingest_video_url) - Ingest Video Url
+* [ingest_image_url](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/ingestassets/README.md#ingest_image_url) - Ingest Image Url
 
 
 ### [namespaces](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md)
 
-* [create_namespace_v1_namespaces_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#create_namespace_v1_namespaces_post) - Create Namespace
-* [list_namespaces_v1_namespaces_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#list_namespaces_v1_namespaces_get) - List Namespaces
-* [delete_namespace_v1_namespaces_namespace_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#delete_namespace_v1_namespaces_namespace_delete) - Delete Namespace
-* [update_namespace_v1_namespaces_namespace_put](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#update_namespace_v1_namespaces_namespace_put) - Update Namespace
-* [get_namespace_v1_namespaces_namespace_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#get_namespace_v1_namespaces_namespace_get) - Get Namespace
-* [list_available_models_v1_namespaces_models_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#list_available_models_v1_namespaces_models_get) - List Available Models
+* [create](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#create) - Create Namespace
+* [list](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#list) - List Namespaces
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#delete) - Delete Namespace
+* [update](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#update) - Update Namespace
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#get) - Get Namespace
+* [list_models](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/namespaces/README.md#list_models) - List Available Models
 
 ### [organizations](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md)
 
-* [get_organization_v1_organizations_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#get_organization_v1_organizations_get) - Get Organization
-* [get_usage_v1_organizations_usage_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#get_usage_v1_organizations_usage_get) - Get Usage
-* [get_user_v1_organizations_users_user_email_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#get_user_v1_organizations_users_user_email_get) - Get User
-* [delete_user_v1_organizations_users_user_email_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#delete_user_v1_organizations_users_user_email_delete) - Delete User
-* [add_user_v1_organizations_users_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#add_user_v1_organizations_users_post) - Add User
-* [create_api_key_v1_organizations_users_user_email_api_keys_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#create_api_key_v1_organizations_users_user_email_api_keys_post) - Create Api Key
-* [delete_api_key_v1_organizations_users_user_email_api_keys_key_name_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#delete_api_key_v1_organizations_users_user_email_api_keys_key_name_delete) - Delete Api Key
-* [update_api_key_v1_organizations_users_user_email_api_keys_key_name_patch](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#update_api_key_v1_organizations_users_user_email_api_keys_key_name_patch) - Update Api Key
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#get) - Get Organization
+* [get_usage](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#get_usage) - Get Usage
+* [add_user](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#add_user) - Add User
+* [delete_api_key](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#delete_api_key) - Delete Api Key
+* [update_api_key](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/organizations/README.md#update_api_key) - Update Api Key
 
 ### [tasks](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/tasks/README.md)
 
-* [kill_task_v1_tasks_task_id_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/tasks/README.md#kill_task_v1_tasks_task_id_delete) - Kill Task
-* [get_task_v1_tasks_task_id_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/tasks/README.md#get_task_v1_tasks_task_id_get) - Get Task Information
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/tasks/README.md#delete) - Kill Task
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/tasks/README.md#get) - Get Task Information
+* [list_active](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/tasks/README.md#list_active) - List Active Tasks
+
+### [taxonomies](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomies/README.md)
+
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomies/README.md#get) - Get Taxonomy
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomies/README.md#delete) - Delete Taxonomy
+* [update](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomies/README.md#update) - Update Taxonomy
 
 ### [taxonomy_entities](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md)
 
-* [create_taxonomy_v1_entities_taxonomies_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#create_taxonomy_v1_entities_taxonomies_post) - Create Taxonomy
-* [list_taxonomies_v1_entities_taxonomies_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#list_taxonomies_v1_entities_taxonomies_get) - List Taxonomies
-* [get_taxonomy_v1_entities_taxonomies_taxonomy_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#get_taxonomy_v1_entities_taxonomies_taxonomy_get) - Get Taxonomy
-* [delete_taxonomy_v1_entities_taxonomies_taxonomy_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#delete_taxonomy_v1_entities_taxonomies_taxonomy_delete) - Delete Taxonomy
-* [update_taxonomy_v1_entities_taxonomies_taxonomy_patch](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#update_taxonomy_v1_entities_taxonomies_taxonomy_patch) - Update Taxonomy
-* [get_taxonomy_node_v1_entities_taxonomies_nodes_node_get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#get_taxonomy_node_v1_entities_taxonomies_nodes_node_get) - Get Taxonomy Node
-* [update_node_v1_entities_taxonomies_nodes_node_patch](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#update_node_v1_entities_taxonomies_nodes_node_patch) - Update Node
-* [classify_features_v1_entities_taxonomies_taxonomy_classify_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#classify_features_v1_entities_taxonomies_taxonomy_classify_post) - Classify Features against Taxonomy
-* [list_classifications_v1_entities_taxonomies_taxonomy_classifications_post](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#list_classifications_v1_entities_taxonomies_taxonomy_classifications_post) - List Taxonomy Classifications
-* [delete_classifications_v1_entities_taxonomies_taxonomy_classifications_classification_id_delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#delete_classifications_v1_entities_taxonomies_taxonomy_classifications_classification_id_delete) - Delete Classifications
+* [create](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#create) - Create Taxonomy
+* [list](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#list) - List Taxonomies
+* [get_node](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#get_node) - Get Taxonomy Node
+* [update_node](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#update_node) - Update Node
+* [classify_features](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#classify_features) - Classify Features against Taxonomy
+* [list_classifications](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#list_classifications) - List Taxonomy Classifications
+* [delete_classification](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/taxonomyentities/README.md#delete_classification) - Delete Classifications
+
+### [users](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/users/README.md)
+
+* [get](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/users/README.md#get) - Get User
+* [delete](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/users/README.md#delete) - Delete User
+* [create_api_key](https://github.com/mixpeek/python-sdk/blob/master/docs/sdks/users/README.md#create_api_key) - Create Api Key
 
 </details>
 <!-- End Available Resources and Operations [operations] -->
@@ -278,7 +288,7 @@ By default, an API error will raise a models.APIError exception, which has the f
 | `.raw_response` | *httpx.Response* | The raw HTTP response |
 | `.body`         | *str*            | The response content  |
 
-When custom error responses are specified for an operation, the SDK may also raise their associated exceptions. You can refer to respective *Errors* tables in SDK docs for more details on possible exception types for each operation. For example, the `get_organization_v1_organizations_get_async` method may raise the following exceptions:
+When custom error responses are specified for an operation, the SDK may also raise their associated exceptions. You can refer to respective *Errors* tables in SDK docs for more details on possible exception types for each operation. For example, the `get_async` method may raise the following exceptions:
 
 | Error Type                 | Status Code        | Content Type     |
 | -------------------------- | ------------------ | ---------------- |
@@ -299,7 +309,7 @@ with Mixpeek(
     res = None
     try:
 
-        res = mixpeek.organizations.get_organization_v1_organizations_get()
+        res = mixpeek.organizations.get()
 
         # Handle response
         print(res)
@@ -423,6 +433,32 @@ s = Mixpeek(async_client=CustomClient(httpx.AsyncClient()))
 ```
 <!-- End Custom HTTP Client [http-client] -->
 
+<!-- Start Resource Management [resource-management] -->
+## Resource Management
+
+The `Mixpeek` class implements the context manager protocol and registers a finalizer function to close the underlying sync and async HTTPX clients it uses under the hood. This will close HTTP connections, release memory and free up other resources held by the SDK. In short-lived Python programs and notebooks that make a few SDK method calls, resource management may not be a concern. However, in longer-lived programs, it is beneficial to create a single SDK instance via a [context manager][context-manager] and reuse it across the application.
+
+[context-manager]: https://docs.python.org/3/reference/datamodel.html#context-managers
+
+```python
+from mixpeek import Mixpeek
+import os
+def main():
+    with Mixpeek(
+        token=os.getenv("MIXPEEK_TOKEN", ""),
+    ) as mixpeek:
+        # Rest of application here...
+
+
+# Or when using async:
+async def amain():
+    async with Mixpeek(
+        token=os.getenv("MIXPEEK_TOKEN", ""),
+    ) as mixpeek:
+        # Rest of application here...
+```
+<!-- End Resource Management [resource-management] -->
+
 <!-- Start Debugging [debug] -->
 ## Debugging
 

{mixpeek-0.17.4 → mixpeek-0.18.7}/pyproject.toml

@@ -1,17 +1,17 @@
 [project]
 name = "mixpeek"
-version = "0.17.4"
+version = "0.18.7"
 description = "Python Client SDK Generated by Speakeasy."
 authors = [{ name = "Speakeasy" },]
 readme = "README-PYPI.md"
 requires-python = ">=3.9"
 dependencies = [
-    "eval-type-backport (>=0.2.0,<0.3.0)",
-    "httpx (>=0.28.1,<0.29.0)",
-    "jsonpath-python (>=1.0.6,<2.0.0)",
-    "pydantic (>=2.10.3,<2.11.0)",
-    "python-dateutil (>=2.8.2,<3.0.0)",
-    "typing-inspect (>=0.9.0,<0.10.0)",
+    "eval-type-backport >=0.2.0",
+    "httpx >=0.28.1",
+    "jsonpath-python >=1.0.6",
+    "pydantic >=2.10.3",
+    "python-dateutil >=2.8.2",
+    "typing-inspect >=0.9.0",
 ]
 
 [tool.poetry]

{mixpeek-0.17.4 → mixpeek-0.18.7}/src/mixpeek/_version.py

@@ -3,10 +3,10 @@
 import importlib.metadata
 
 __title__: str = "mixpeek"
-__version__: str = "0.17.4"
+__version__: str = "0.18.7"
 __openapi_doc_version__: str = "0.81"
-__gen_version__: str = "2.493.19"
-__user_agent__: str = "speakeasy-sdk/python 0.17.4 2.493.19 0.81 mixpeek"
+__gen_version__: str = "2.496.0"
+__user_agent__: str = "speakeasy-sdk/python 0.18.7 2.496.0 0.81 mixpeek"
 
 try:
     if __package__ is not None: