arize 8.0.0a21__py3-none-any.whl → 8.0.0a23__py3-none-any.whl

arize/_generated/api_client/api/datasets_api.py

@@ -3,9 +3,9 @@
 """
     Arize REST API
 
-    API specification for the backend data server. The API is hosted globally at https://api.arize.com/v2 or in your own environment. You can access the OpenAPI spec for this API at https://api.arize.com/v2/spec.yaml 
+    API specification for the backend data server. The API is hosted globally at https://api.arize.com/v2 or in your own environment. 
 
-    The version of the OpenAPI document: 0.0.1
+    The version of the OpenAPI document: 2.0.0
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
@@ -16,13 +16,15 @@ from pydantic import validate_call, Field, StrictFloat, StrictStr, StrictInt
 from typing import Any, Dict, List, Optional, Tuple, Union
 from typing_extensions import Annotated
 
-from pydantic import Field, StrictInt, StrictStr
+from pydantic import Field, StrictStr
 from typing import Optional
 from typing_extensions import Annotated
 from arize._generated.api_client.models.dataset import Dataset
 from arize._generated.api_client.models.datasets_create_request import DatasetsCreateRequest
+from arize._generated.api_client.models.datasets_examples_insert_request import DatasetsExamplesInsertRequest
+from arize._generated.api_client.models.datasets_examples_list200_response import DatasetsExamplesList200Response
+from arize._generated.api_client.models.datasets_examples_update_request import DatasetsExamplesUpdateRequest
 from arize._generated.api_client.models.datasets_list200_response import DatasetsList200Response
-from arize._generated.api_client.models.datasets_list_examples200_response import DatasetsListExamples200Response
 
 from arize._generated.api_client.api_client import ApiClient, RequestSerialized
 from arize._generated.api_client.api_response import ApiResponse
@@ -59,8 +61,9 @@ class DatasetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> Dataset:
-        """Create a new dataset with JSON examples
+        """Create a dataset
 
+        Create a new dataset with JSON examples. Empty datasets are not allowed.  **Payload Requirements** - The dataset name must be unique within the given space. - Each item in `examples[]` may contain **any user-defined fields**. - Do not include system-managed fields on input: `id`, `created_at`, `updated_at`. Requests that contain these fields in any example **will be rejected**. - Each example **must contain at least one property** (i.e., `{}` is invalid).  **Valid example** (create) ```json {   \"name\": \"my-dataset\",   \"space_id\": \"spc_123\",   \"examples\": [     {       \"question\": \"What is 2+2?\",       \"answer\": \"4\",       \"topic\": \"math\"     },     {       \"question\": \"What is the capital of Spain?\",       \"answer\": \"Madrid\",       \"topic\": \"geography\"     },   ] } ```  **Invalid example** ('id' not allowed on create) ```json {   \"name\": \"my-dataset\",   \"space_id\": \"spc_123\",   \"examples\": [     {       \"id\": \"ex_1\",       \"input\": \"Hello\"     }   ] } ```  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
         :param datasets_create_request: Body containing dataset creation parameters (required)
         :type datasets_create_request: DatasetsCreateRequest
@@ -96,10 +99,10 @@ class DatasetsApi:
 
         _response_types_map: Dict[str, Optional[str]] = {
             '201': "Dataset",
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '409': "Error",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '409': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -129,8 +132,9 @@ class DatasetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> ApiResponse[Dataset]:
-        """Create a new dataset with JSON examples
+        """Create a dataset
 
+        Create a new dataset with JSON examples. Empty datasets are not allowed.  **Payload Requirements** - The dataset name must be unique within the given space. - Each item in `examples[]` may contain **any user-defined fields**. - Do not include system-managed fields on input: `id`, `created_at`, `updated_at`. Requests that contain these fields in any example **will be rejected**. - Each example **must contain at least one property** (i.e., `{}` is invalid).  **Valid example** (create) ```json {   \"name\": \"my-dataset\",   \"space_id\": \"spc_123\",   \"examples\": [     {       \"question\": \"What is 2+2?\",       \"answer\": \"4\",       \"topic\": \"math\"     },     {       \"question\": \"What is the capital of Spain?\",       \"answer\": \"Madrid\",       \"topic\": \"geography\"     },   ] } ```  **Invalid example** ('id' not allowed on create) ```json {   \"name\": \"my-dataset\",   \"space_id\": \"spc_123\",   \"examples\": [     {       \"id\": \"ex_1\",       \"input\": \"Hello\"     }   ] } ```  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
         :param datasets_create_request: Body containing dataset creation parameters (required)
         :type datasets_create_request: DatasetsCreateRequest
@@ -166,10 +170,10 @@ class DatasetsApi:
 
         _response_types_map: Dict[str, Optional[str]] = {
             '201': "Dataset",
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '409': "Error",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '409': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -199,8 +203,9 @@ class DatasetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Create a new dataset with JSON examples
+        """Create a dataset
 
+        Create a new dataset with JSON examples. Empty datasets are not allowed.  **Payload Requirements** - The dataset name must be unique within the given space. - Each item in `examples[]` may contain **any user-defined fields**. - Do not include system-managed fields on input: `id`, `created_at`, `updated_at`. Requests that contain these fields in any example **will be rejected**. - Each example **must contain at least one property** (i.e., `{}` is invalid).  **Valid example** (create) ```json {   \"name\": \"my-dataset\",   \"space_id\": \"spc_123\",   \"examples\": [     {       \"question\": \"What is 2+2?\",       \"answer\": \"4\",       \"topic\": \"math\"     },     {       \"question\": \"What is the capital of Spain?\",       \"answer\": \"Madrid\",       \"topic\": \"geography\"     },   ] } ```  **Invalid example** ('id' not allowed on create) ```json {   \"name\": \"my-dataset\",   \"space_id\": \"spc_123\",   \"examples\": [     {       \"id\": \"ex_1\",       \"input\": \"Hello\"     }   ] } ```  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
         :param datasets_create_request: Body containing dataset creation parameters (required)
         :type datasets_create_request: DatasetsCreateRequest
@@ -236,10 +241,10 @@ class DatasetsApi:
 
         _response_types_map: Dict[str, Optional[str]] = {
             '201': "Dataset",
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '409': "Error",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '409': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -284,7 +289,8 @@ class DatasetsApi:
         if 'Accept' not in _header_params:
             _header_params['Accept'] = self.api_client.select_header_accept(
                 [
-                    'application/json'
+                    'application/json', 
+                    'application/problem+json'
                 ]
             )
 
@@ -304,7 +310,7 @@ class DatasetsApi:
 
         # authentication setting
         _auth_settings: List[str] = [
-            'ApiKeyAuth'
+            'bearerAuth'
         ]
 
         return self.api_client.param_serialize(
@@ -342,8 +348,9 @@ class DatasetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> None:
-        """Delete a dataset by ID
+        """Delete a dataset
 
+        Delete a dataset by its ID. This operation is irreversible.  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
         :param dataset_id: The unique identifier of the dataset (required)
         :type dataset_id: str
@@ -379,12 +386,12 @@ class DatasetsApi:
 
         _response_types_map: Dict[str, Optional[str]] = {
             '204': None,
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '404': "Error",
-            '422': "Error",
-            '429': "Error",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '422': "Problem",
+            '429': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -414,8 +421,9 @@ class DatasetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> ApiResponse[None]:
-        """Delete a dataset by ID
+        """Delete a dataset
 
+        Delete a dataset by its ID. This operation is irreversible.  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
         :param dataset_id: The unique identifier of the dataset (required)
         :type dataset_id: str
@@ -451,12 +459,12 @@ class DatasetsApi:
 
         _response_types_map: Dict[str, Optional[str]] = {
             '204': None,
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '404': "Error",
-            '422': "Error",
-            '429': "Error",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '422': "Problem",
+            '429': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -486,8 +494,9 @@ class DatasetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Delete a dataset by ID
+        """Delete a dataset
 
+        Delete a dataset by its ID. This operation is irreversible.  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
         :param dataset_id: The unique identifier of the dataset (required)
         :type dataset_id: str
@@ -523,12 +532,12 @@ class DatasetsApi:
 
         _response_types_map: Dict[str, Optional[str]] = {
             '204': None,
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '404': "Error",
-            '422': "Error",
-            '429': "Error",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '422': "Problem",
+            '429': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -562,7 +571,7 @@ class DatasetsApi:
 
         # process the path parameters
         if dataset_id is not None:
-            _path_params['datasetId'] = dataset_id
+            _path_params['dataset_id'] = dataset_id
         # process the query parameters
         # process the header parameters
         # process the form parameters
@@ -573,19 +582,19 @@ class DatasetsApi:
         if 'Accept' not in _header_params:
             _header_params['Accept'] = self.api_client.select_header_accept(
                 [
-                    'application/json'
+                    'application/problem+json'
                 ]
             )
 
 
         # authentication setting
         _auth_settings: List[str] = [
-            'ApiKeyAuth'
+            'bearerAuth'
         ]
 
         return self.api_client.param_serialize(
             method='DELETE',
-            resource_path='/v2/datasets/{datasetId}',
+            resource_path='/v2/datasets/{dataset_id}',
             path_params=_path_params,
             query_params=_query_params,
             header_params=_header_params,
@@ -602,9 +611,10 @@ class DatasetsApi:
 
 
     @validate_call
-    def datasets_get(
+    def datasets_examples_insert(
         self,
         dataset_id: Annotated[StrictStr, Field(description="The unique identifier of the dataset")],
+        datasets_examples_insert_request: Annotated[DatasetsExamplesInsertRequest, Field(description="Body containing dataset examples for insert (append) operation with auto-generated IDs")],
         dataset_version_id: Annotated[Optional[StrictStr], Field(description="The unique identifier of the dataset version")] = None,
         _request_timeout: Union[
             None,
@@ -619,11 +629,14 @@ class DatasetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> Dataset:
-        """Get dataset by ID
+        """Add new examples to a dataset
 
+        Appends new examples to an existing dataset.  If the dataset version is not passed, the latest version is selected. The inserted examples will be assigned autogenerated, unique IDs.  **Payload Requirements** - Each item in `examples[]` may contain any user-defined fields. - Do not include system-managed fields on input: `id`, `created_at`, `updated_at`. Requests that contain these fields in any example will be rejected. - Each example must contain at least one property (i.e., `{}` is invalid).  **Valid example** (create) ```json {   \"examples\": [     { \"question\": \"What is 2+2?\",       \"answer\": \"4\",       \"topic\": \"math\"     }   ] } ```  **Invalid example** ('id' not allowed on create) ```json {   \"examples\": [     {       \"id\": \"ex_1\",       \"input\": \"Hello\"     }   ] } ```  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
         :param dataset_id: The unique identifier of the dataset (required)
         :type dataset_id: str
+        :param datasets_examples_insert_request: Body containing dataset examples for insert (append) operation with auto-generated IDs (required)
+        :type datasets_examples_insert_request: DatasetsExamplesInsertRequest
         :param dataset_version_id: The unique identifier of the dataset version
         :type dataset_version_id: str
         :param _request_timeout: timeout setting for this request. If one
@@ -648,8 +661,9 @@ class DatasetsApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._datasets_get_serialize(
+        _param = self._datasets_examples_insert_serialize(
             dataset_id=dataset_id,
+            datasets_examples_insert_request=datasets_examples_insert_request,
             dataset_version_id=dataset_version_id,
             _request_auth=_request_auth,
             _content_type=_content_type,
@@ -659,12 +673,12 @@ class DatasetsApi:
 
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "Dataset",
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '404': "Error",
-            '422': "Error",
-            '429': "Error",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '422': "Problem",
+            '429': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -678,9 +692,10 @@ class DatasetsApi:
 
 
     @validate_call
-    def datasets_get_with_http_info(
+    def datasets_examples_insert_with_http_info(
         self,
         dataset_id: Annotated[StrictStr, Field(description="The unique identifier of the dataset")],
+        datasets_examples_insert_request: Annotated[DatasetsExamplesInsertRequest, Field(description="Body containing dataset examples for insert (append) operation with auto-generated IDs")],
         dataset_version_id: Annotated[Optional[StrictStr], Field(description="The unique identifier of the dataset version")] = None,
         _request_timeout: Union[
             None,
@@ -695,11 +710,14 @@ class DatasetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> ApiResponse[Dataset]:
-        """Get dataset by ID
+        """Add new examples to a dataset
 
+        Appends new examples to an existing dataset.  If the dataset version is not passed, the latest version is selected. The inserted examples will be assigned autogenerated, unique IDs.  **Payload Requirements** - Each item in `examples[]` may contain any user-defined fields. - Do not include system-managed fields on input: `id`, `created_at`, `updated_at`. Requests that contain these fields in any example will be rejected. - Each example must contain at least one property (i.e., `{}` is invalid).  **Valid example** (create) ```json {   \"examples\": [     { \"question\": \"What is 2+2?\",       \"answer\": \"4\",       \"topic\": \"math\"     }   ] } ```  **Invalid example** ('id' not allowed on create) ```json {   \"examples\": [     {       \"id\": \"ex_1\",       \"input\": \"Hello\"     }   ] } ```  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
         :param dataset_id: The unique identifier of the dataset (required)
         :type dataset_id: str
+        :param datasets_examples_insert_request: Body containing dataset examples for insert (append) operation with auto-generated IDs (required)
+        :type datasets_examples_insert_request: DatasetsExamplesInsertRequest
         :param dataset_version_id: The unique identifier of the dataset version
         :type dataset_version_id: str
         :param _request_timeout: timeout setting for this request. If one
@@ -724,8 +742,9 @@ class DatasetsApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._datasets_get_serialize(
+        _param = self._datasets_examples_insert_serialize(
             dataset_id=dataset_id,
+            datasets_examples_insert_request=datasets_examples_insert_request,
             dataset_version_id=dataset_version_id,
             _request_auth=_request_auth,
             _content_type=_content_type,
@@ -735,12 +754,12 @@ class DatasetsApi:
 
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "Dataset",
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '404': "Error",
-            '422': "Error",
-            '429': "Error",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '422': "Problem",
+            '429': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -754,9 +773,10 @@ class DatasetsApi:
 
 
     @validate_call
-    def datasets_get_without_preload_content(
+    def datasets_examples_insert_without_preload_content(
         self,
         dataset_id: Annotated[StrictStr, Field(description="The unique identifier of the dataset")],
+        datasets_examples_insert_request: Annotated[DatasetsExamplesInsertRequest, Field(description="Body containing dataset examples for insert (append) operation with auto-generated IDs")],
         dataset_version_id: Annotated[Optional[StrictStr], Field(description="The unique identifier of the dataset version")] = None,
         _request_timeout: Union[
             None,
@@ -771,11 +791,14 @@ class DatasetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Get dataset by ID
+        """Add new examples to a dataset
 
+        Appends new examples to an existing dataset.  If the dataset version is not passed, the latest version is selected. The inserted examples will be assigned autogenerated, unique IDs.  **Payload Requirements** - Each item in `examples[]` may contain any user-defined fields. - Do not include system-managed fields on input: `id`, `created_at`, `updated_at`. Requests that contain these fields in any example will be rejected. - Each example must contain at least one property (i.e., `{}` is invalid).  **Valid example** (create) ```json {   \"examples\": [     { \"question\": \"What is 2+2?\",       \"answer\": \"4\",       \"topic\": \"math\"     }   ] } ```  **Invalid example** ('id' not allowed on create) ```json {   \"examples\": [     {       \"id\": \"ex_1\",       \"input\": \"Hello\"     }   ] } ```  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
         :param dataset_id: The unique identifier of the dataset (required)
         :type dataset_id: str
+        :param datasets_examples_insert_request: Body containing dataset examples for insert (append) operation with auto-generated IDs (required)
+        :type datasets_examples_insert_request: DatasetsExamplesInsertRequest
         :param dataset_version_id: The unique identifier of the dataset version
         :type dataset_version_id: str
         :param _request_timeout: timeout setting for this request. If one
@@ -800,8 +823,9 @@ class DatasetsApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._datasets_get_serialize(
+        _param = self._datasets_examples_insert_serialize(
             dataset_id=dataset_id,
+            datasets_examples_insert_request=datasets_examples_insert_request,
             dataset_version_id=dataset_version_id,
             _request_auth=_request_auth,
             _content_type=_content_type,
@@ -811,12 +835,12 @@ class DatasetsApi:
 
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "Dataset",
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '404': "Error",
-            '422': "Error",
-            '429': "Error",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '422': "Problem",
+            '429': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -825,9 +849,10 @@ class DatasetsApi:
         return response_data.response
 
 
-    def _datasets_get_serialize(
+    def _datasets_examples_insert_serialize(
         self,
         dataset_id,
+        datasets_examples_insert_request,
         dataset_version_id,
         _request_auth,
         _content_type,
@@ -851,34 +876,50 @@ class DatasetsApi:
 
         # process the path parameters
         if dataset_id is not None:
-            _path_params['datasetId'] = dataset_id
+            _path_params['dataset_id'] = dataset_id
         # process the query parameters
         if dataset_version_id is not None:
             
-            _query_params.append(('datasetVersionId', dataset_version_id))
+            _query_params.append(('dataset_version_id', dataset_version_id))
             
         # process the header parameters
         # process the form parameters
         # process the body parameter
+        if datasets_examples_insert_request is not None:
+            _body_params = datasets_examples_insert_request
 
 
         # set the HTTP header `Accept`
         if 'Accept' not in _header_params:
             _header_params['Accept'] = self.api_client.select_header_accept(
                 [
-                    'application/json'
+                    'application/json', 
+                    'application/problem+json'
                 ]
             )
 
+        # set the HTTP header `Content-Type`
+        if _content_type:
+            _header_params['Content-Type'] = _content_type
+        else:
+            _default_content_type = (
+                self.api_client.select_header_content_type(
+                    [
+                        'application/json'
+                    ]
+                )
+            )
+            if _default_content_type is not None:
+                _header_params['Content-Type'] = _default_content_type
 
         # authentication setting
         _auth_settings: List[str] = [
-            'ApiKeyAuth'
+            'bearerAuth'
         ]
 
         return self.api_client.param_serialize(
-            method='GET',
-            resource_path='/v2/datasets/{datasetId}',
+            method='POST',
+            resource_path='/v2/datasets/{dataset_id}/examples',
             path_params=_path_params,
             query_params=_query_params,
             header_params=_header_params,
@@ -895,10 +936,11 @@ class DatasetsApi:
 
 
     @validate_call
-    def datasets_list(
+    def datasets_examples_list(
         self,
-        space_id: Annotated[Optional[StrictStr], Field(description="Filter search results to a particular space ID")] = None,
-        limit: Annotated[Optional[StrictInt], Field(description="Maximum number of items to return")] = None,
+        dataset_id: Annotated[StrictStr, Field(description="The unique identifier of the dataset")],
+        dataset_version_id: Annotated[Optional[StrictStr], Field(description="The unique identifier of the dataset version")] = None,
+        limit: Annotated[Optional[Annotated[int, Field(le=10000, strict=True, ge=1)]], Field(description="Maximum items to return")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -911,13 +953,16 @@ class DatasetsApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> DatasetsList200Response:
-        """List datasets the user has access to
+    ) -> DatasetsExamplesList200Response:
+        """List dataset examples
 
+        List examples for a given dataset and version.  If version is not passed, the latest version is selected. Examples are sorted by insertion order.  **Pagination**: - Response includes `pagination` for forward compatibility. - **Currently not implemented**: `pagination.next_cursor` is omitted - When pagination is enabled in the future, the behavior will match other list endpoints (cursor-based, opaque tokens).  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
-        :param space_id: Filter search results to a particular space ID
-        :type space_id: str
-        :param limit: Maximum number of items to return
+        :param dataset_id: The unique identifier of the dataset (required)
+        :type dataset_id: str
+        :param dataset_version_id: The unique identifier of the dataset version
+        :type dataset_version_id: str
+        :param limit: Maximum items to return
         :type limit: int
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -941,8 +986,9 @@ class DatasetsApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._datasets_list_serialize(
-            space_id=space_id,
+        _param = self._datasets_examples_list_serialize(
+            dataset_id=dataset_id,
+            dataset_version_id=dataset_version_id,
             limit=limit,
             _request_auth=_request_auth,
             _content_type=_content_type,
@@ -951,12 +997,13 @@ class DatasetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "DatasetsList200Response",
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '422': "Error",
-            '429': "Error",
+            '200': "DatasetsExamplesList200Response",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '422': "Problem",
+            '429': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -970,10 +1017,11 @@ class DatasetsApi:
 
 
     @validate_call
-    def datasets_list_with_http_info(
+    def datasets_examples_list_with_http_info(
         self,
-        space_id: Annotated[Optional[StrictStr], Field(description="Filter search results to a particular space ID")] = None,
-        limit: Annotated[Optional[StrictInt], Field(description="Maximum number of items to return")] = None,
+        dataset_id: Annotated[StrictStr, Field(description="The unique identifier of the dataset")],
+        dataset_version_id: Annotated[Optional[StrictStr], Field(description="The unique identifier of the dataset version")] = None,
+        limit: Annotated[Optional[Annotated[int, Field(le=10000, strict=True, ge=1)]], Field(description="Maximum items to return")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -986,13 +1034,16 @@ class DatasetsApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[DatasetsList200Response]:
-        """List datasets the user has access to
+    ) -> ApiResponse[DatasetsExamplesList200Response]:
+        """List dataset examples
 
+        List examples for a given dataset and version.  If version is not passed, the latest version is selected. Examples are sorted by insertion order.  **Pagination**: - Response includes `pagination` for forward compatibility. - **Currently not implemented**: `pagination.next_cursor` is omitted - When pagination is enabled in the future, the behavior will match other list endpoints (cursor-based, opaque tokens).  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
-        :param space_id: Filter search results to a particular space ID
-        :type space_id: str
-        :param limit: Maximum number of items to return
+        :param dataset_id: The unique identifier of the dataset (required)
+        :type dataset_id: str
+        :param dataset_version_id: The unique identifier of the dataset version
+        :type dataset_version_id: str
+        :param limit: Maximum items to return
         :type limit: int
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -1016,8 +1067,9 @@ class DatasetsApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._datasets_list_serialize(
-            space_id=space_id,
+        _param = self._datasets_examples_list_serialize(
+            dataset_id=dataset_id,
+            dataset_version_id=dataset_version_id,
             limit=limit,
             _request_auth=_request_auth,
             _content_type=_content_type,
@@ -1026,12 +1078,13 @@ class DatasetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "DatasetsList200Response",
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '422': "Error",
-            '429': "Error",
+            '200': "DatasetsExamplesList200Response",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '422': "Problem",
+            '429': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1045,10 +1098,11 @@ class DatasetsApi:
 
 
     @validate_call
-    def datasets_list_without_preload_content(
+    def datasets_examples_list_without_preload_content(
         self,
-        space_id: Annotated[Optional[StrictStr], Field(description="Filter search results to a particular space ID")] = None,
-        limit: Annotated[Optional[StrictInt], Field(description="Maximum number of items to return")] = None,
+        dataset_id: Annotated[StrictStr, Field(description="The unique identifier of the dataset")],
+        dataset_version_id: Annotated[Optional[StrictStr], Field(description="The unique identifier of the dataset version")] = None,
+        limit: Annotated[Optional[Annotated[int, Field(le=10000, strict=True, ge=1)]], Field(description="Maximum items to return")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1062,12 +1116,15 @@ class DatasetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """List datasets the user has access to
+        """List dataset examples
 
+        List examples for a given dataset and version.  If version is not passed, the latest version is selected. Examples are sorted by insertion order.  **Pagination**: - Response includes `pagination` for forward compatibility. - **Currently not implemented**: `pagination.next_cursor` is omitted - When pagination is enabled in the future, the behavior will match other list endpoints (cursor-based, opaque tokens).  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
-        :param space_id: Filter search results to a particular space ID
-        :type space_id: str
-        :param limit: Maximum number of items to return
+        :param dataset_id: The unique identifier of the dataset (required)
+        :type dataset_id: str
+        :param dataset_version_id: The unique identifier of the dataset version
+        :type dataset_version_id: str
+        :param limit: Maximum items to return
         :type limit: int
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -1091,8 +1148,9 @@ class DatasetsApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._datasets_list_serialize(
-            space_id=space_id,
+        _param = self._datasets_examples_list_serialize(
+            dataset_id=dataset_id,
+            dataset_version_id=dataset_version_id,
             limit=limit,
             _request_auth=_request_auth,
             _content_type=_content_type,
@@ -1101,12 +1159,13 @@ class DatasetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "DatasetsList200Response",
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '422': "Error",
-            '429': "Error",
+            '200': "DatasetsExamplesList200Response",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '422': "Problem",
+            '429': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1115,9 +1174,10 @@ class DatasetsApi:
         return response_data.response
 
 
-    def _datasets_list_serialize(
+    def _datasets_examples_list_serialize(
         self,
-        space_id,
+        dataset_id,
+        dataset_version_id,
         limit,
         _request_auth,
         _content_type,
@@ -1140,10 +1200,12 @@ class DatasetsApi:
         _body_params: Optional[bytes] = None
 
         # process the path parameters
+        if dataset_id is not None:
+            _path_params['dataset_id'] = dataset_id
         # process the query parameters
-        if space_id is not None:
+        if dataset_version_id is not None:
             
-            _query_params.append(('spaceId', space_id))
+            _query_params.append(('dataset_version_id', dataset_version_id))
             
         if limit is not None:
             
@@ -1158,19 +1220,20 @@ class DatasetsApi:
         if 'Accept' not in _header_params:
             _header_params['Accept'] = self.api_client.select_header_accept(
                 [
-                    'application/json'
+                    'application/json', 
+                    'application/problem+json'
                 ]
             )
 
 
         # authentication setting
         _auth_settings: List[str] = [
-            'ApiKeyAuth'
+            'bearerAuth'
         ]
 
         return self.api_client.param_serialize(
             method='GET',
-            resource_path='/v2/datasets',
+            resource_path='/v2/datasets/{dataset_id}/examples',
             path_params=_path_params,
             query_params=_query_params,
             header_params=_header_params,
@@ -1187,11 +1250,11 @@ class DatasetsApi:
 
 
     @validate_call
-    def datasets_list_examples(
+    def datasets_examples_update(
         self,
         dataset_id: Annotated[StrictStr, Field(description="The unique identifier of the dataset")],
+        datasets_examples_update_request: Annotated[DatasetsExamplesUpdateRequest, Field(description="Body containing dataset examples for update operation by ID matching")],
         dataset_version_id: Annotated[Optional[StrictStr], Field(description="The unique identifier of the dataset version")] = None,
-        limit: Annotated[Optional[StrictInt], Field(description="Maximum number of items to return")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1204,16 +1267,17 @@ class DatasetsApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> DatasetsListExamples200Response:
-        """List examples for a dataset
+    ) -> Dataset:
+        """Update existing examples in a dataset
 
+        Updates existing dataset examples by matching their `id` field.  an example ID does not match any existing example in the dataset version, it will be ignored. In other words, only examples with IDs that already exist will be updated. To add new examples, use the Insert Dataset Examples endpoint.  Adding columns that do not exist in the dataset schema is allowed, but removing existing columns is not.  Optionally, the update can create a new version of the dataset. In this case, the outcome of the update will be reflected only in the new version, while the previous version remains unchanged. If a new version is not created, the updates will be applied directly (in place) to the specified version.  **Payload Requirements** - Each item in `examples[]` may contain any user-defined fields. - Each item in `examples[]` must include the `id` field to identify the example to update. - Do not include system-managed fields on input: `created_at`, `updated_at`. Requests that contain these fields in any example will be rejected. - Each example must contain at least one property (i.e., `{}` is invalid).  **Valid example** (create) ```json {   \"examples\": [     {       \"id\": \"ex_001\",       \"question\": \"What is 2+2?\",       \"answer\": \"4\",       \"topic\": \"math\"     }   ] } ```  **Invalid example** ('id' missing for update) ```json {   \"examples\": [     {       \"input\": \"Hello\"     }   ] } ```  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
         :param dataset_id: The unique identifier of the dataset (required)
         :type dataset_id: str
+        :param datasets_examples_update_request: Body containing dataset examples for update operation by ID matching (required)
+        :type datasets_examples_update_request: DatasetsExamplesUpdateRequest
         :param dataset_version_id: The unique identifier of the dataset version
         :type dataset_version_id: str
-        :param limit: Maximum number of items to return
-        :type limit: int
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1236,10 +1300,10 @@ class DatasetsApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._datasets_list_examples_serialize(
+        _param = self._datasets_examples_update_serialize(
             dataset_id=dataset_id,
+            datasets_examples_update_request=datasets_examples_update_request,
             dataset_version_id=dataset_version_id,
-            limit=limit,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1247,13 +1311,14 @@ class DatasetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "DatasetsListExamples200Response",
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '404': "Error",
-            '422': "Error",
-            '429': "Error",
+            '200': "Dataset",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '409': "Problem",
+            '422': "Problem",
+            '429': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1267,11 +1332,11 @@ class DatasetsApi:
 
 
     @validate_call
-    def datasets_list_examples_with_http_info(
+    def datasets_examples_update_with_http_info(
         self,
         dataset_id: Annotated[StrictStr, Field(description="The unique identifier of the dataset")],
+        datasets_examples_update_request: Annotated[DatasetsExamplesUpdateRequest, Field(description="Body containing dataset examples for update operation by ID matching")],
         dataset_version_id: Annotated[Optional[StrictStr], Field(description="The unique identifier of the dataset version")] = None,
-        limit: Annotated[Optional[StrictInt], Field(description="Maximum number of items to return")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1284,16 +1349,17 @@ class DatasetsApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[DatasetsListExamples200Response]:
-        """List examples for a dataset
+    ) -> ApiResponse[Dataset]:
+        """Update existing examples in a dataset
 
+        Updates existing dataset examples by matching their `id` field.  an example ID does not match any existing example in the dataset version, it will be ignored. In other words, only examples with IDs that already exist will be updated. To add new examples, use the Insert Dataset Examples endpoint.  Adding columns that do not exist in the dataset schema is allowed, but removing existing columns is not.  Optionally, the update can create a new version of the dataset. In this case, the outcome of the update will be reflected only in the new version, while the previous version remains unchanged. If a new version is not created, the updates will be applied directly (in place) to the specified version.  **Payload Requirements** - Each item in `examples[]` may contain any user-defined fields. - Each item in `examples[]` must include the `id` field to identify the example to update. - Do not include system-managed fields on input: `created_at`, `updated_at`. Requests that contain these fields in any example will be rejected. - Each example must contain at least one property (i.e., `{}` is invalid).  **Valid example** (create) ```json {   \"examples\": [     {       \"id\": \"ex_001\",       \"question\": \"What is 2+2?\",       \"answer\": \"4\",       \"topic\": \"math\"     }   ] } ```  **Invalid example** ('id' missing for update) ```json {   \"examples\": [     {       \"input\": \"Hello\"     }   ] } ```  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
         :param dataset_id: The unique identifier of the dataset (required)
         :type dataset_id: str
+        :param datasets_examples_update_request: Body containing dataset examples for update operation by ID matching (required)
+        :type datasets_examples_update_request: DatasetsExamplesUpdateRequest
         :param dataset_version_id: The unique identifier of the dataset version
         :type dataset_version_id: str
-        :param limit: Maximum number of items to return
-        :type limit: int
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1316,10 +1382,10 @@ class DatasetsApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._datasets_list_examples_serialize(
+        _param = self._datasets_examples_update_serialize(
             dataset_id=dataset_id,
+            datasets_examples_update_request=datasets_examples_update_request,
             dataset_version_id=dataset_version_id,
-            limit=limit,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1327,13 +1393,14 @@ class DatasetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "DatasetsListExamples200Response",
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '404': "Error",
-            '422': "Error",
-            '429': "Error",
+            '200': "Dataset",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '409': "Problem",
+            '422': "Problem",
+            '429': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1347,11 +1414,11 @@ class DatasetsApi:
 
 
     @validate_call
-    def datasets_list_examples_without_preload_content(
+    def datasets_examples_update_without_preload_content(
         self,
         dataset_id: Annotated[StrictStr, Field(description="The unique identifier of the dataset")],
+        datasets_examples_update_request: Annotated[DatasetsExamplesUpdateRequest, Field(description="Body containing dataset examples for update operation by ID matching")],
         dataset_version_id: Annotated[Optional[StrictStr], Field(description="The unique identifier of the dataset version")] = None,
-        limit: Annotated[Optional[StrictInt], Field(description="Maximum number of items to return")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1365,15 +1432,16 @@ class DatasetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """List examples for a dataset
+        """Update existing examples in a dataset
 
+        Updates existing dataset examples by matching their `id` field.  an example ID does not match any existing example in the dataset version, it will be ignored. In other words, only examples with IDs that already exist will be updated. To add new examples, use the Insert Dataset Examples endpoint.  Adding columns that do not exist in the dataset schema is allowed, but removing existing columns is not.  Optionally, the update can create a new version of the dataset. In this case, the outcome of the update will be reflected only in the new version, while the previous version remains unchanged. If a new version is not created, the updates will be applied directly (in place) to the specified version.  **Payload Requirements** - Each item in `examples[]` may contain any user-defined fields. - Each item in `examples[]` must include the `id` field to identify the example to update. - Do not include system-managed fields on input: `created_at`, `updated_at`. Requests that contain these fields in any example will be rejected. - Each example must contain at least one property (i.e., `{}` is invalid).  **Valid example** (create) ```json {   \"examples\": [     {       \"id\": \"ex_001\",       \"question\": \"What is 2+2?\",       \"answer\": \"4\",       \"topic\": \"math\"     }   ] } ```  **Invalid example** ('id' missing for update) ```json {   \"examples\": [     {       \"input\": \"Hello\"     }   ] } ```  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
 
         :param dataset_id: The unique identifier of the dataset (required)
         :type dataset_id: str
+        :param datasets_examples_update_request: Body containing dataset examples for update operation by ID matching (required)
+        :type datasets_examples_update_request: DatasetsExamplesUpdateRequest
         :param dataset_version_id: The unique identifier of the dataset version
         :type dataset_version_id: str
-        :param limit: Maximum number of items to return
-        :type limit: int
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1396,10 +1464,10 @@ class DatasetsApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._datasets_list_examples_serialize(
+        _param = self._datasets_examples_update_serialize(
             dataset_id=dataset_id,
+            datasets_examples_update_request=datasets_examples_update_request,
             dataset_version_id=dataset_version_id,
-            limit=limit,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1407,13 +1475,14 @@ class DatasetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "DatasetsListExamples200Response",
-            '400': "Error",
-            '401': "Error",
-            '403': "Error",
-            '404': "Error",
-            '422': "Error",
-            '429': "Error",
+            '200': "Dataset",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '409': "Problem",
+            '422': "Problem",
+            '429': "Problem",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1422,11 +1491,11 @@ class DatasetsApi:
         return response_data.response
 
 
-    def _datasets_list_examples_serialize(
+    def _datasets_examples_update_serialize(
         self,
         dataset_id,
+        datasets_examples_update_request,
         dataset_version_id,
-        limit,
         _request_auth,
         _content_type,
         _headers,
@@ -1449,38 +1518,643 @@ class DatasetsApi:
 
         # process the path parameters
         if dataset_id is not None:
-            _path_params['datasetId'] = dataset_id
+            _path_params['dataset_id'] = dataset_id
         # process the query parameters
         if dataset_version_id is not None:
             
-            _query_params.append(('datasetVersionId', dataset_version_id))
-            
-        if limit is not None:
-            
-            _query_params.append(('limit', limit))
+            _query_params.append(('dataset_version_id', dataset_version_id))
             
         # process the header parameters
         # process the form parameters
         # process the body parameter
+        if datasets_examples_update_request is not None:
+            _body_params = datasets_examples_update_request
 
 
         # set the HTTP header `Accept`
         if 'Accept' not in _header_params:
             _header_params['Accept'] = self.api_client.select_header_accept(
                 [
-                    'application/json'
+                    'application/json', 
+                    'application/problem+json'
                 ]
             )
 
+        # set the HTTP header `Content-Type`
+        if _content_type:
+            _header_params['Content-Type'] = _content_type
+        else:
+            _default_content_type = (
+                self.api_client.select_header_content_type(
+                    [
+                        'application/json'
+                    ]
+                )
+            )
+            if _default_content_type is not None:
+                _header_params['Content-Type'] = _default_content_type
 
         # authentication setting
         _auth_settings: List[str] = [
-            'ApiKeyAuth'
+            'bearerAuth'
         ]
 
         return self.api_client.param_serialize(
-            method='GET',
-            resource_path='/v2/datasets/{datasetId}/examples',
+            method='PATCH',
+            resource_path='/v2/datasets/{dataset_id}/examples',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def datasets_get(
+        self,
+        dataset_id: Annotated[StrictStr, Field(description="The unique identifier of the dataset")],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> Dataset:
+        """Get a dataset
+
+        Get a dataset object by its ID.  This includes the dataset's versions, sorted by creation date, with the most recently-created version first.  This endpoint does not include the dataset's examples. To get the examples of a specific dataset version, use the List Dataset Examples endpoint.  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
+
+        :param dataset_id: The unique identifier of the dataset (required)
+        :type dataset_id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._datasets_get_serialize(
+            dataset_id=dataset_id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Dataset",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '422': "Problem",
+            '429': "Problem",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def datasets_get_with_http_info(
+        self,
+        dataset_id: Annotated[StrictStr, Field(description="The unique identifier of the dataset")],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[Dataset]:
+        """Get a dataset
+
+        Get a dataset object by its ID.  This includes the dataset's versions, sorted by creation date, with the most recently-created version first.  This endpoint does not include the dataset's examples. To get the examples of a specific dataset version, use the List Dataset Examples endpoint.  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
+
+        :param dataset_id: The unique identifier of the dataset (required)
+        :type dataset_id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._datasets_get_serialize(
+            dataset_id=dataset_id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Dataset",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '422': "Problem",
+            '429': "Problem",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def datasets_get_without_preload_content(
+        self,
+        dataset_id: Annotated[StrictStr, Field(description="The unique identifier of the dataset")],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Get a dataset
+
+        Get a dataset object by its ID.  This includes the dataset's versions, sorted by creation date, with the most recently-created version first.  This endpoint does not include the dataset's examples. To get the examples of a specific dataset version, use the List Dataset Examples endpoint.  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
+
+        :param dataset_id: The unique identifier of the dataset (required)
+        :type dataset_id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._datasets_get_serialize(
+            dataset_id=dataset_id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Dataset",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '422': "Problem",
+            '429': "Problem",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _datasets_get_serialize(
+        self,
+        dataset_id,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if dataset_id is not None:
+            _path_params['dataset_id'] = dataset_id
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json', 
+                    'application/problem+json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'bearerAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/v2/datasets/{dataset_id}',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def datasets_list(
+        self,
+        space_id: Annotated[Optional[StrictStr], Field(description="Filter search results to a particular space ID")] = None,
+        limit: Annotated[Optional[Annotated[int, Field(le=500, strict=True, ge=1)]], Field(description="Maximum items to return")] = None,
+        cursor: Annotated[Optional[StrictStr], Field(description="Opaque pagination cursor returned from a previous response (`pagination.next_cursor`). Treat it as an unreadable token; do not attempt to parse or construct it. ")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> DatasetsList200Response:
+        """List datasets
+
+        List datasets the user has access to.  The datasets are sorted by creation date, with the most recently created datasets coming first.  The dataset versions are not included in this response. To get the versions of a specific dataset, use the Get Dataset by ID endpoint.  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
+
+        :param space_id: Filter search results to a particular space ID
+        :type space_id: str
+        :param limit: Maximum items to return
+        :type limit: int
+        :param cursor: Opaque pagination cursor returned from a previous response (`pagination.next_cursor`). Treat it as an unreadable token; do not attempt to parse or construct it. 
+        :type cursor: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._datasets_list_serialize(
+            space_id=space_id,
+            limit=limit,
+            cursor=cursor,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "DatasetsList200Response",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '422': "Problem",
+            '429': "Problem",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def datasets_list_with_http_info(
+        self,
+        space_id: Annotated[Optional[StrictStr], Field(description="Filter search results to a particular space ID")] = None,
+        limit: Annotated[Optional[Annotated[int, Field(le=500, strict=True, ge=1)]], Field(description="Maximum items to return")] = None,
+        cursor: Annotated[Optional[StrictStr], Field(description="Opaque pagination cursor returned from a previous response (`pagination.next_cursor`). Treat it as an unreadable token; do not attempt to parse or construct it. ")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[DatasetsList200Response]:
+        """List datasets
+
+        List datasets the user has access to.  The datasets are sorted by creation date, with the most recently created datasets coming first.  The dataset versions are not included in this response. To get the versions of a specific dataset, use the Get Dataset by ID endpoint.  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
+
+        :param space_id: Filter search results to a particular space ID
+        :type space_id: str
+        :param limit: Maximum items to return
+        :type limit: int
+        :param cursor: Opaque pagination cursor returned from a previous response (`pagination.next_cursor`). Treat it as an unreadable token; do not attempt to parse or construct it. 
+        :type cursor: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._datasets_list_serialize(
+            space_id=space_id,
+            limit=limit,
+            cursor=cursor,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "DatasetsList200Response",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '422': "Problem",
+            '429': "Problem",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def datasets_list_without_preload_content(
+        self,
+        space_id: Annotated[Optional[StrictStr], Field(description="Filter search results to a particular space ID")] = None,
+        limit: Annotated[Optional[Annotated[int, Field(le=500, strict=True, ge=1)]], Field(description="Maximum items to return")] = None,
+        cursor: Annotated[Optional[StrictStr], Field(description="Opaque pagination cursor returned from a previous response (`pagination.next_cursor`). Treat it as an unreadable token; do not attempt to parse or construct it. ")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """List datasets
+
+        List datasets the user has access to.  The datasets are sorted by creation date, with the most recently created datasets coming first.  The dataset versions are not included in this response. To get the versions of a specific dataset, use the Get Dataset by ID endpoint.  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note> 
+
+        :param space_id: Filter search results to a particular space ID
+        :type space_id: str
+        :param limit: Maximum items to return
+        :type limit: int
+        :param cursor: Opaque pagination cursor returned from a previous response (`pagination.next_cursor`). Treat it as an unreadable token; do not attempt to parse or construct it. 
+        :type cursor: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._datasets_list_serialize(
+            space_id=space_id,
+            limit=limit,
+            cursor=cursor,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "DatasetsList200Response",
+            '400': "Problem",
+            '401': "Problem",
+            '403': "Problem",
+            '422': "Problem",
+            '429': "Problem",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _datasets_list_serialize(
+        self,
+        space_id,
+        limit,
+        cursor,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        # process the query parameters
+        if space_id is not None:
+            
+            _query_params.append(('space_id', space_id))
+            
+        if limit is not None:
+            
+            _query_params.append(('limit', limit))
+            
+        if cursor is not None:
+            
+            _query_params.append(('cursor', cursor))
+            
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json', 
+                    'application/problem+json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'bearerAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/v2/datasets',
             path_params=_path_params,
             query_params=_query_params,
             header_params=_header_params,