mixpeek 0.20.20__py3-none-any.whl → 0.21.6__py3-none-any.whl

mixpeek/{ingestassets.py → retrievers.py}

@@ -8,41 +8,44 @@ from mixpeek.utils import get_security_from_env
 from typing import Any, List, Mapping, Optional, Union
 
 
-class IngestAssets(BaseSDK):
-    def ingest_text(
+class Retrievers(BaseSDK):
+    def create(
         self,
         *,
-        collection: str,
+        retriever_name: str,
+        input_schema: Union[
+            models.BucketSchemaInput, models.BucketSchemaInputTypedDict
+        ],
+        collection_ids: List[str],
+        stages: Union[
+            List[models.StageConfigInput], List[models.StageConfigInputTypedDict]
+        ],
         x_namespace: OptionalNullable[str] = UNSET,
-        asset_update: OptionalNullable[
-            Union[models.AssetUpdate, models.AssetUpdateTypedDict]
-        ] = UNSET,
+        description: OptionalNullable[str] = UNSET,
         metadata: Optional[
             Union[
-                models.ProcessTextInputMetadata,
-                models.ProcessTextInputMetadataTypedDict,
+                models.CreateRetrieverRequestMetadata,
+                models.CreateRetrieverRequestMetadataTypedDict,
             ]
         ] = None,
-        feature_extractors: OptionalNullable[
-            Union[models.TextSettings, models.TextSettingsTypedDict]
+        cache_config: OptionalNullable[
+            Union[models.RetrieverCacheConfig, models.RetrieverCacheConfigTypedDict]
         ] = UNSET,
-        skip_duplicate: OptionalNullable[bool] = UNSET,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TaskResponse:
-        r"""Ingest Text
-
-        **Requirements:**
-        - Required permissions: write
+    ) -> models.RetrieverModel:
+        r"""Create Retriever
 
-        :param collection: Unique identifier for the collection where the processed asset will be stored, can be the collection name or collection ID. If neither exist, the collection will be created.
+        :param retriever_name: Name of the retriever
+        :param input_schema: Schema definition for bucket objects
+        :param collection_ids: List of collection IDs to search in
+        :param stages: List of stages to execute in order
         :param x_namespace: Optional namespace for data isolation. This can be a namespace name or namespace ID. Example: 'netflix_prod' or 'ns_1234567890'. To create a namespace, use the /namespaces endpoint.
-        :param asset_update: Controls how processing results are stored - either creating a new asset or updating an existing one.
-        :param metadata: Additional metadata associated with the file. Can include any key-value pairs relevant to the file.
-        :param feature_extractors: Settings for text processing.
-        :param skip_duplicate: Skips processing when a duplicate hash is found and stores an error by the task_id with the existing asset_id
+        :param description: Description of the retriever
+        :param metadata:
+        :param cache_config: Configuration for retriever-level caching
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -58,26 +61,28 @@ class IngestAssets(BaseSDK):
         else:
             base_url = self._get_url(base_url, url_variables)
 
-        request = models.IngestTextV1IngestTextPostRequest(
+        request = models.CreateRetrieverV1RetrieversRetrieversPostRequest(
             x_namespace=x_namespace,
-            process_text_input=models.ProcessTextInput(
-                collection=collection,
-                asset_update=utils.get_pydantic_model(
-                    asset_update, OptionalNullable[models.AssetUpdate]
+            create_retriever_request=models.CreateRetrieverRequest(
+                retriever_name=retriever_name,
+                description=description,
+                input_schema=utils.get_pydantic_model(
+                    input_schema, models.BucketSchemaInput
                 ),
+                collection_ids=collection_ids,
+                stages=utils.get_pydantic_model(stages, List[models.StageConfigInput]),
                 metadata=utils.get_pydantic_model(
-                    metadata, Optional[models.ProcessTextInputMetadata]
+                    metadata, Optional[models.CreateRetrieverRequestMetadata]
                 ),
-                feature_extractors=utils.get_pydantic_model(
-                    feature_extractors, OptionalNullable[models.TextSettings]
+                cache_config=utils.get_pydantic_model(
+                    cache_config, OptionalNullable[models.RetrieverCacheConfig]
                 ),
-                skip_duplicate=skip_duplicate,
             ),
         )
 
         req = self._build_request(
             method="POST",
-            path="/v1/ingest/text",
+            path="/v1/retrievers/retrievers",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
@@ -89,11 +94,11 @@ class IngestAssets(BaseSDK):
             http_headers=http_headers,
             security=self.sdk_configuration.security,
             get_serialized_body=lambda: utils.serialize_request_body(
-                request.process_text_input,
+                request.create_retriever_request,
                 False,
                 False,
                 "json",
-                models.ProcessTextInput,
+                models.CreateRetrieverRequest,
             ),
             timeout_ms=timeout_ms,
         )
@@ -109,7 +114,7 @@ class IngestAssets(BaseSDK):
         http_res = self.do_request(
             hook_ctx=HookContext(
                 base_url=base_url or "",
-                operation_id="ingest_text_v1_ingest_text_post",
+                operation_id="create_retriever_v1_retrievers_retrievers_post",
                 oauth2_scopes=[],
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
@@ -122,7 +127,7 @@ class IngestAssets(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TaskResponse)
+            return utils.unmarshal_json(http_res.text, models.RetrieverModel)
         if utils.match_response(
             http_res, ["400", "401", "403", "404"], "application/json"
         ):
@@ -160,40 +165,43 @@ class IngestAssets(BaseSDK):
             http_res,
         )
 
-    async def ingest_text_async(
+    async def create_async(
         self,
         *,
-        collection: str,
+        retriever_name: str,
+        input_schema: Union[
+            models.BucketSchemaInput, models.BucketSchemaInputTypedDict
+        ],
+        collection_ids: List[str],
+        stages: Union[
+            List[models.StageConfigInput], List[models.StageConfigInputTypedDict]
+        ],
         x_namespace: OptionalNullable[str] = UNSET,
-        asset_update: OptionalNullable[
-            Union[models.AssetUpdate, models.AssetUpdateTypedDict]
-        ] = UNSET,
+        description: OptionalNullable[str] = UNSET,
         metadata: Optional[
             Union[
-                models.ProcessTextInputMetadata,
-                models.ProcessTextInputMetadataTypedDict,
+                models.CreateRetrieverRequestMetadata,
+                models.CreateRetrieverRequestMetadataTypedDict,
             ]
         ] = None,
-        feature_extractors: OptionalNullable[
-            Union[models.TextSettings, models.TextSettingsTypedDict]
+        cache_config: OptionalNullable[
+            Union[models.RetrieverCacheConfig, models.RetrieverCacheConfigTypedDict]
         ] = UNSET,
-        skip_duplicate: OptionalNullable[bool] = UNSET,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TaskResponse:
-        r"""Ingest Text
+    ) -> models.RetrieverModel:
+        r"""Create Retriever
 
-        **Requirements:**
-        - Required permissions: write
-
-        :param collection: Unique identifier for the collection where the processed asset will be stored, can be the collection name or collection ID. If neither exist, the collection will be created.
+        :param retriever_name: Name of the retriever
+        :param input_schema: Schema definition for bucket objects
+        :param collection_ids: List of collection IDs to search in
+        :param stages: List of stages to execute in order
         :param x_namespace: Optional namespace for data isolation. This can be a namespace name or namespace ID. Example: 'netflix_prod' or 'ns_1234567890'. To create a namespace, use the /namespaces endpoint.
-        :param asset_update: Controls how processing results are stored - either creating a new asset or updating an existing one.
-        :param metadata: Additional metadata associated with the file. Can include any key-value pairs relevant to the file.
-        :param feature_extractors: Settings for text processing.
-        :param skip_duplicate: Skips processing when a duplicate hash is found and stores an error by the task_id with the existing asset_id
+        :param description: Description of the retriever
+        :param metadata:
+        :param cache_config: Configuration for retriever-level caching
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -209,26 +217,28 @@ class IngestAssets(BaseSDK):
         else:
             base_url = self._get_url(base_url, url_variables)
 
-        request = models.IngestTextV1IngestTextPostRequest(
+        request = models.CreateRetrieverV1RetrieversRetrieversPostRequest(
             x_namespace=x_namespace,
-            process_text_input=models.ProcessTextInput(
-                collection=collection,
-                asset_update=utils.get_pydantic_model(
-                    asset_update, OptionalNullable[models.AssetUpdate]
+            create_retriever_request=models.CreateRetrieverRequest(
+                retriever_name=retriever_name,
+                description=description,
+                input_schema=utils.get_pydantic_model(
+                    input_schema, models.BucketSchemaInput
                 ),
+                collection_ids=collection_ids,
+                stages=utils.get_pydantic_model(stages, List[models.StageConfigInput]),
                 metadata=utils.get_pydantic_model(
-                    metadata, Optional[models.ProcessTextInputMetadata]
+                    metadata, Optional[models.CreateRetrieverRequestMetadata]
                 ),
-                feature_extractors=utils.get_pydantic_model(
-                    feature_extractors, OptionalNullable[models.TextSettings]
+                cache_config=utils.get_pydantic_model(
+                    cache_config, OptionalNullable[models.RetrieverCacheConfig]
                 ),
-                skip_duplicate=skip_duplicate,
             ),
         )
 
         req = self._build_request_async(
             method="POST",
-            path="/v1/ingest/text",
+            path="/v1/retrievers/retrievers",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
@@ -240,11 +250,11 @@ class IngestAssets(BaseSDK):
             http_headers=http_headers,
             security=self.sdk_configuration.security,
             get_serialized_body=lambda: utils.serialize_request_body(
-                request.process_text_input,
+                request.create_retriever_request,
                 False,
                 False,
                 "json",
-                models.ProcessTextInput,
+                models.CreateRetrieverRequest,
             ),
             timeout_ms=timeout_ms,
         )
@@ -260,7 +270,7 @@ class IngestAssets(BaseSDK):
         http_res = await self.do_request_async(
             hook_ctx=HookContext(
                 base_url=base_url or "",
-                operation_id="ingest_text_v1_ingest_text_post",
+                operation_id="create_retriever_v1_retrievers_retrievers_post",
                 oauth2_scopes=[],
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
@@ -273,7 +283,7 @@ class IngestAssets(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TaskResponse)
+            return utils.unmarshal_json(http_res.text, models.RetrieverModel)
         if utils.match_response(
             http_res, ["400", "401", "403", "404"], "application/json"
         ):
@@ -311,42 +321,20 @@ class IngestAssets(BaseSDK):
             http_res,
         )
 
-    def ingest_video_url(
+    def get(
         self,
         *,
-        url: str,
-        collection: str,
+        retriever_id: str,
         x_namespace: OptionalNullable[str] = UNSET,
-        asset_update: OptionalNullable[
-            Union[models.AssetUpdate, models.AssetUpdateTypedDict]
-        ] = UNSET,
-        metadata: Optional[
-            Union[
-                models.ProcessVideoURLInputMetadata,
-                models.ProcessVideoURLInputMetadataTypedDict,
-            ]
-        ] = None,
-        skip_duplicate: OptionalNullable[bool] = UNSET,
-        feature_extractors: OptionalNullable[
-            Union[List[models.VideoSettings], List[models.VideoSettingsTypedDict]]
-        ] = UNSET,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TaskResponse:
-        r"""Ingest Video Url
-
-        **Requirements:**
-        - Required permissions: write
+    ) -> models.RetrieverModel:
+        r"""Get Retriever
 
-        :param url: The URL of the asset to be processed. Must be a valid HTTP or HTTPS URL.
-        :param collection: Unique identifier for the collection where the processed asset will be stored, can be the collection name or collection ID. If neither exist, the collection will be created.
+        :param retriever_id:
         :param x_namespace: Optional namespace for data isolation. This can be a namespace name or namespace ID. Example: 'netflix_prod' or 'ns_1234567890'. To create a namespace, use the /namespaces endpoint.
-        :param asset_update: Controls how processing results are stored - either creating a new asset or updating an existing one.
-        :param metadata: Additional metadata associated with the asset. Can include any key-value pairs relevant to the asset.
-        :param skip_duplicate: Makes feature extraction idempotent. When True and a duplicate file hash is found, copies features from the existing asset instead of reprocessing. This allows the same file to be used multiple times with different metadata while avoiding redundant processing.
-        :param feature_extractors: Settings for video processing. Only applicable if the URL points to a video file.
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -362,44 +350,24 @@ class IngestAssets(BaseSDK):
         else:
             base_url = self._get_url(base_url, url_variables)
 
-        request = models.IngestVideoURLV1IngestVideosURLPostRequest(
+        request = models.GetRetrieverV1RetrieversRetrieversRetrieverIDGetRequest(
+            retriever_id=retriever_id,
             x_namespace=x_namespace,
-            process_video_url_input=models.ProcessVideoURLInput(
-                url=url,
-                collection=collection,
-                asset_update=utils.get_pydantic_model(
-                    asset_update, OptionalNullable[models.AssetUpdate]
-                ),
-                metadata=utils.get_pydantic_model(
-                    metadata, Optional[models.ProcessVideoURLInputMetadata]
-                ),
-                skip_duplicate=skip_duplicate,
-                feature_extractors=utils.get_pydantic_model(
-                    feature_extractors, OptionalNullable[List[models.VideoSettings]]
-                ),
-            ),
         )
 
         req = self._build_request(
-            method="POST",
-            path="/v1/ingest/videos/url",
+            method="GET",
+            path="/v1/retrievers/retrievers/{retriever_id}",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
-            request_body_required=True,
-            request_has_path_params=False,
+            request_body_required=False,
+            request_has_path_params=True,
             request_has_query_params=True,
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
             security=self.sdk_configuration.security,
-            get_serialized_body=lambda: utils.serialize_request_body(
-                request.process_video_url_input,
-                False,
-                False,
-                "json",
-                models.ProcessVideoURLInput,
-            ),
             timeout_ms=timeout_ms,
         )
 
@@ -414,7 +382,7 @@ class IngestAssets(BaseSDK):
         http_res = self.do_request(
             hook_ctx=HookContext(
                 base_url=base_url or "",
-                operation_id="ingest_video_url_v1_ingest_videos_url_post",
+                operation_id="get_retriever_v1_retrievers_retrievers__retriever_id__get",
                 oauth2_scopes=[],
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
@@ -427,7 +395,7 @@ class IngestAssets(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TaskResponse)
+            return utils.unmarshal_json(http_res.text, models.RetrieverModel)
         if utils.match_response(
             http_res, ["400", "401", "403", "404"], "application/json"
         ):
@@ -465,42 +433,20 @@ class IngestAssets(BaseSDK):
             http_res,
         )
 
-    async def ingest_video_url_async(
+    async def get_async(
         self,
         *,
-        url: str,
-        collection: str,
+        retriever_id: str,
         x_namespace: OptionalNullable[str] = UNSET,
-        asset_update: OptionalNullable[
-            Union[models.AssetUpdate, models.AssetUpdateTypedDict]
-        ] = UNSET,
-        metadata: Optional[
-            Union[
-                models.ProcessVideoURLInputMetadata,
-                models.ProcessVideoURLInputMetadataTypedDict,
-            ]
-        ] = None,
-        skip_duplicate: OptionalNullable[bool] = UNSET,
-        feature_extractors: OptionalNullable[
-            Union[List[models.VideoSettings], List[models.VideoSettingsTypedDict]]
-        ] = UNSET,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TaskResponse:
-        r"""Ingest Video Url
+    ) -> models.RetrieverModel:
+        r"""Get Retriever
 
-        **Requirements:**
-        - Required permissions: write
-
-        :param url: The URL of the asset to be processed. Must be a valid HTTP or HTTPS URL.
-        :param collection: Unique identifier for the collection where the processed asset will be stored, can be the collection name or collection ID. If neither exist, the collection will be created.
+        :param retriever_id:
         :param x_namespace: Optional namespace for data isolation. This can be a namespace name or namespace ID. Example: 'netflix_prod' or 'ns_1234567890'. To create a namespace, use the /namespaces endpoint.
-        :param asset_update: Controls how processing results are stored - either creating a new asset or updating an existing one.
-        :param metadata: Additional metadata associated with the asset. Can include any key-value pairs relevant to the asset.
-        :param skip_duplicate: Makes feature extraction idempotent. When True and a duplicate file hash is found, copies features from the existing asset instead of reprocessing. This allows the same file to be used multiple times with different metadata while avoiding redundant processing.
-        :param feature_extractors: Settings for video processing. Only applicable if the URL points to a video file.
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -516,44 +462,24 @@ class IngestAssets(BaseSDK):
         else:
             base_url = self._get_url(base_url, url_variables)
 
-        request = models.IngestVideoURLV1IngestVideosURLPostRequest(
+        request = models.GetRetrieverV1RetrieversRetrieversRetrieverIDGetRequest(
+            retriever_id=retriever_id,
             x_namespace=x_namespace,
-            process_video_url_input=models.ProcessVideoURLInput(
-                url=url,
-                collection=collection,
-                asset_update=utils.get_pydantic_model(
-                    asset_update, OptionalNullable[models.AssetUpdate]
-                ),
-                metadata=utils.get_pydantic_model(
-                    metadata, Optional[models.ProcessVideoURLInputMetadata]
-                ),
-                skip_duplicate=skip_duplicate,
-                feature_extractors=utils.get_pydantic_model(
-                    feature_extractors, OptionalNullable[List[models.VideoSettings]]
-                ),
-            ),
         )
 
         req = self._build_request_async(
-            method="POST",
-            path="/v1/ingest/videos/url",
+            method="GET",
+            path="/v1/retrievers/retrievers/{retriever_id}",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
-            request_body_required=True,
-            request_has_path_params=False,
+            request_body_required=False,
+            request_has_path_params=True,
             request_has_query_params=True,
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
             security=self.sdk_configuration.security,
-            get_serialized_body=lambda: utils.serialize_request_body(
-                request.process_video_url_input,
-                False,
-                False,
-                "json",
-                models.ProcessVideoURLInput,
-            ),
             timeout_ms=timeout_ms,
         )
 
@@ -568,7 +494,7 @@ class IngestAssets(BaseSDK):
         http_res = await self.do_request_async(
             hook_ctx=HookContext(
                 base_url=base_url or "",
-                operation_id="ingest_video_url_v1_ingest_videos_url_post",
+                operation_id="get_retriever_v1_retrievers_retrievers__retriever_id__get",
                 oauth2_scopes=[],
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
@@ -581,7 +507,7 @@ class IngestAssets(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TaskResponse)
+            return utils.unmarshal_json(http_res.text, models.RetrieverModel)
         if utils.match_response(
             http_res, ["400", "401", "403", "404"], "application/json"
         ):
@@ -619,42 +545,43 @@ class IngestAssets(BaseSDK):
             http_res,
         )
 
-    def ingest_image_url(
+    def execute(
         self,
         *,
-        url: str,
-        collection: str,
+        retriever_id: str,
+        inputs: Union[
+            models.RetrieverQueryRequestInputs,
+            models.RetrieverQueryRequestInputsTypedDict,
+        ],
         x_namespace: OptionalNullable[str] = UNSET,
-        asset_update: OptionalNullable[
-            Union[models.AssetUpdate, models.AssetUpdateTypedDict]
+        filters: OptionalNullable[
+            Union[models.LogicalOperatorInput, models.LogicalOperatorInputTypedDict]
         ] = UNSET,
-        metadata: Optional[
-            Union[
-                models.ProcessImageURLInputMetadata,
-                models.ProcessImageURLInputMetadataTypedDict,
-            ]
-        ] = None,
-        skip_duplicate: OptionalNullable[bool] = UNSET,
-        feature_extractors: OptionalNullable[
-            Union[models.ImageSettings, models.ImageSettingsTypedDict]
+        sorts: OptionalNullable[
+            Union[List[models.SortOption], List[models.SortOptionTypedDict]]
         ] = UNSET,
+        limit: Optional[int] = 10,
+        offset: Optional[int] = 0,
+        select: OptionalNullable[List[str]] = UNSET,
+        session_id: OptionalNullable[str] = UNSET,
+        return_urls: Optional[bool] = False,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TaskResponse:
-        r"""Ingest Image Url
-
-        **Requirements:**
-        - Required permissions: write
+    ) -> models.RetrieverResponse:
+        r"""Execute Retriever
 
-        :param url: The URL of the asset to be processed. Must be a valid HTTP or HTTPS URL.
-        :param collection: Unique identifier for the collection where the processed asset will be stored, can be the collection name or collection ID. If neither exist, the collection will be created.
+        :param retriever_id:
+        :param inputs: Input values for the retriever query. These map to the required inputs defined in the retriever's first stage.
         :param x_namespace: Optional namespace for data isolation. This can be a namespace name or namespace ID. Example: 'netflix_prod' or 'ns_1234567890'. To create a namespace, use the /namespaces endpoint.
-        :param asset_update: Controls how processing results are stored - either creating a new asset or updating an existing one.
-        :param metadata: Additional metadata associated with the asset. Can include any key-value pairs relevant to the asset.
-        :param skip_duplicate: Makes feature extraction idempotent. When True and a duplicate file hash is found, copies features from the existing asset instead of reprocessing. This allows the same file to be used multiple times with different metadata while avoiding redundant processing.
-        :param feature_extractors: Settings for image processing. Only applicable if the URL points to an image file.
+        :param filters: Logical operations for filtering results. Can include AND, OR, NOT conditions with field comparisons.
+        :param sorts: Controls the ordering of results. Can sort by score (default) or any other document field. This sorts the results from the last stage.
+        :param limit: Maximum number of results to return. Overrides the default pagination limit in the retriever definition.
+        :param offset: Number of results to skip. Use with limit for pagination. For large offsets, consider using session_id for cursor-based pagination.
+        :param select: Specific fields to include in the response. If not specified, returns all fields.
+        :param session_id: Session identifier for interaction tracking.
+        :param return_urls: When true, generates pre-signed URLs for any media assets in the results. May increase response time slightly.
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -670,43 +597,48 @@ class IngestAssets(BaseSDK):
         else:
             base_url = self._get_url(base_url, url_variables)
 
-        request = models.IngestImageURLV1IngestImagesURLPostRequest(
-            x_namespace=x_namespace,
-            process_image_url_input=models.ProcessImageURLInput(
-                url=url,
-                collection=collection,
-                asset_update=utils.get_pydantic_model(
-                    asset_update, OptionalNullable[models.AssetUpdate]
-                ),
-                metadata=utils.get_pydantic_model(
-                    metadata, Optional[models.ProcessImageURLInputMetadata]
-                ),
-                skip_duplicate=skip_duplicate,
-                feature_extractors=utils.get_pydantic_model(
-                    feature_extractors, OptionalNullable[models.ImageSettings]
+        request = (
+            models.ExecuteRetrieverV1RetrieversRetrieversRetrieverIDExecutePostRequest(
+                retriever_id=retriever_id,
+                x_namespace=x_namespace,
+                retriever_query_request=models.RetrieverQueryRequest(
+                    inputs=utils.get_pydantic_model(
+                        inputs, models.RetrieverQueryRequestInputs
+                    ),
+                    filters=utils.get_pydantic_model(
+                        filters, OptionalNullable[models.LogicalOperatorInput]
+                    ),
+                    sorts=utils.get_pydantic_model(
+                        sorts, OptionalNullable[List[models.SortOption]]
+                    ),
+                    limit=limit,
+                    offset=offset,
+                    select=select,
+                    session_id=session_id,
+                    return_urls=return_urls,
                 ),
-            ),
+            )
         )
 
         req = self._build_request(
             method="POST",
-            path="/v1/ingest/images/url",
+            path="/v1/retrievers/retrievers/{retriever_id}/execute",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
             request_body_required=True,
-            request_has_path_params=False,
+            request_has_path_params=True,
             request_has_query_params=True,
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
             security=self.sdk_configuration.security,
             get_serialized_body=lambda: utils.serialize_request_body(
-                request.process_image_url_input,
+                request.retriever_query_request,
                 False,
                 False,
                 "json",
-                models.ProcessImageURLInput,
+                models.RetrieverQueryRequest,
             ),
             timeout_ms=timeout_ms,
         )
@@ -722,7 +654,7 @@ class IngestAssets(BaseSDK):
         http_res = self.do_request(
             hook_ctx=HookContext(
                 base_url=base_url or "",
-                operation_id="ingest_image_url_v1_ingest_images_url_post",
+                operation_id="execute_retriever_v1_retrievers_retrievers__retriever_id__execute_post",
                 oauth2_scopes=[],
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
@@ -735,7 +667,7 @@ class IngestAssets(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TaskResponse)
+            return utils.unmarshal_json(http_res.text, models.RetrieverResponse)
         if utils.match_response(
             http_res, ["400", "401", "403", "404"], "application/json"
         ):
@@ -773,42 +705,43 @@ class IngestAssets(BaseSDK):
             http_res,
         )
 
-    async def ingest_image_url_async(
+    async def execute_async(
         self,
         *,
-        url: str,
-        collection: str,
+        retriever_id: str,
+        inputs: Union[
+            models.RetrieverQueryRequestInputs,
+            models.RetrieverQueryRequestInputsTypedDict,
+        ],
         x_namespace: OptionalNullable[str] = UNSET,
-        asset_update: OptionalNullable[
-            Union[models.AssetUpdate, models.AssetUpdateTypedDict]
+        filters: OptionalNullable[
+            Union[models.LogicalOperatorInput, models.LogicalOperatorInputTypedDict]
         ] = UNSET,
-        metadata: Optional[
-            Union[
-                models.ProcessImageURLInputMetadata,
-                models.ProcessImageURLInputMetadataTypedDict,
-            ]
-        ] = None,
-        skip_duplicate: OptionalNullable[bool] = UNSET,
-        feature_extractors: OptionalNullable[
-            Union[models.ImageSettings, models.ImageSettingsTypedDict]
+        sorts: OptionalNullable[
+            Union[List[models.SortOption], List[models.SortOptionTypedDict]]
         ] = UNSET,
+        limit: Optional[int] = 10,
+        offset: Optional[int] = 0,
+        select: OptionalNullable[List[str]] = UNSET,
+        session_id: OptionalNullable[str] = UNSET,
+        return_urls: Optional[bool] = False,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TaskResponse:
-        r"""Ingest Image Url
+    ) -> models.RetrieverResponse:
+        r"""Execute Retriever
 
-        **Requirements:**
-        - Required permissions: write
-
-        :param url: The URL of the asset to be processed. Must be a valid HTTP or HTTPS URL.
-        :param collection: Unique identifier for the collection where the processed asset will be stored, can be the collection name or collection ID. If neither exist, the collection will be created.
+        :param retriever_id:
+        :param inputs: Input values for the retriever query. These map to the required inputs defined in the retriever's first stage.
         :param x_namespace: Optional namespace for data isolation. This can be a namespace name or namespace ID. Example: 'netflix_prod' or 'ns_1234567890'. To create a namespace, use the /namespaces endpoint.
-        :param asset_update: Controls how processing results are stored - either creating a new asset or updating an existing one.
-        :param metadata: Additional metadata associated with the asset. Can include any key-value pairs relevant to the asset.
-        :param skip_duplicate: Makes feature extraction idempotent. When True and a duplicate file hash is found, copies features from the existing asset instead of reprocessing. This allows the same file to be used multiple times with different metadata while avoiding redundant processing.
-        :param feature_extractors: Settings for image processing. Only applicable if the URL points to an image file.
+        :param filters: Logical operations for filtering results. Can include AND, OR, NOT conditions with field comparisons.
+        :param sorts: Controls the ordering of results. Can sort by score (default) or any other document field. This sorts the results from the last stage.
+        :param limit: Maximum number of results to return. Overrides the default pagination limit in the retriever definition.
+        :param offset: Number of results to skip. Use with limit for pagination. For large offsets, consider using session_id for cursor-based pagination.
+        :param select: Specific fields to include in the response. If not specified, returns all fields.
+        :param session_id: Session identifier for interaction tracking.
+        :param return_urls: When true, generates pre-signed URLs for any media assets in the results. May increase response time slightly.
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -824,43 +757,48 @@ class IngestAssets(BaseSDK):
         else:
             base_url = self._get_url(base_url, url_variables)
 
-        request = models.IngestImageURLV1IngestImagesURLPostRequest(
-            x_namespace=x_namespace,
-            process_image_url_input=models.ProcessImageURLInput(
-                url=url,
-                collection=collection,
-                asset_update=utils.get_pydantic_model(
-                    asset_update, OptionalNullable[models.AssetUpdate]
-                ),
-                metadata=utils.get_pydantic_model(
-                    metadata, Optional[models.ProcessImageURLInputMetadata]
+        request = (
+            models.ExecuteRetrieverV1RetrieversRetrieversRetrieverIDExecutePostRequest(
+                retriever_id=retriever_id,
+                x_namespace=x_namespace,
+                retriever_query_request=models.RetrieverQueryRequest(
+                    inputs=utils.get_pydantic_model(
+                        inputs, models.RetrieverQueryRequestInputs
+                    ),
+                    filters=utils.get_pydantic_model(
+                        filters, OptionalNullable[models.LogicalOperatorInput]
+                    ),
+                    sorts=utils.get_pydantic_model(
+                        sorts, OptionalNullable[List[models.SortOption]]
+                    ),
+                    limit=limit,
+                    offset=offset,
+                    select=select,
+                    session_id=session_id,
+                    return_urls=return_urls,
                 ),
-                skip_duplicate=skip_duplicate,
-                feature_extractors=utils.get_pydantic_model(
-                    feature_extractors, OptionalNullable[models.ImageSettings]
-                ),
-            ),
+            )
         )
 
         req = self._build_request_async(
             method="POST",
-            path="/v1/ingest/images/url",
+            path="/v1/retrievers/retrievers/{retriever_id}/execute",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
             request_body_required=True,
-            request_has_path_params=False,
+            request_has_path_params=True,
             request_has_query_params=True,
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
             security=self.sdk_configuration.security,
             get_serialized_body=lambda: utils.serialize_request_body(
-                request.process_image_url_input,
+                request.retriever_query_request,
                 False,
                 False,
                 "json",
-                models.ProcessImageURLInput,
+                models.RetrieverQueryRequest,
             ),
             timeout_ms=timeout_ms,
         )
@@ -876,7 +814,7 @@ class IngestAssets(BaseSDK):
         http_res = await self.do_request_async(
             hook_ctx=HookContext(
                 base_url=base_url or "",
-                operation_id="ingest_image_url_v1_ingest_images_url_post",
+                operation_id="execute_retriever_v1_retrievers_retrievers__retriever_id__execute_post",
                 oauth2_scopes=[],
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
@@ -889,7 +827,7 @@ class IngestAssets(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TaskResponse)
+            return utils.unmarshal_json(http_res.text, models.RetrieverResponse)
         if utils.match_response(
             http_res, ["400", "401", "403", "404"], "application/json"
         ):