label-studio-sdk 1.0.19__py3-none-any.whl → 2.0.0__py3-none-any.whl

label_studio_sdk/import_storage/s3/client.py

@@ -4,12 +4,10 @@ import typing
 from ...core.client_wrapper import SyncClientWrapper
 from ...core.request_options import RequestOptions
 from ...types.s3import_storage import S3ImportStorage
-from ...core.pydantic_utilities import parse_obj_as
+from ...core.unchecked_base_model import construct_type
 from json.decoder import JSONDecodeError
 from ...core.api_error import ApiError
-from .types.s3create_response import S3CreateResponse
 from ...core.jsonable_encoder import jsonable_encoder
-from .types.s3update_response import S3UpdateResponse
 from ...core.client_wrapper import AsyncClientWrapper
 
 # this is used as the default value for optional parameters
@@ -21,18 +19,20 @@ class S3Client:
         self._client_wrapper = client_wrapper
 
     def list(
-        self, *, project: typing.Optional[int] = None, request_options: typing.Optional[RequestOptions] = None
+        self,
+        *,
+        ordering: typing.Optional[str] = None,
+        project: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[S3ImportStorage]:
         """
-
-        You can connect your S3 bucket to Label Studio as a source storage or target storage. Use this API request to get a list of all Google import (source) storage connections for a specific project.
-
-        The project ID can be found in the URL when viewing the project in Label Studio, or you can retrieve all project IDs using [List all projects](../projects/list).
-
-        For more information about working with external storage, see [Sync data from external storage](https://labelstud.io/guide/storage).
+        Get a list of all S3 import storage connections.
 
         Parameters
         ----------
+        ordering : typing.Optional[str]
+            Which field to use when ordering the results.
+
         project : typing.Optional[int]
             Project ID
 
@@ -57,6 +57,7 @@ class S3Client:
             "api/storages/s3/",
             method="GET",
             params={
+                "ordering": ordering,
                 "project": project,
             },
             request_options=request_options,
@@ -65,7 +66,7 @@ class S3Client:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
                     typing.List[S3ImportStorage],
-                    parse_obj_as(
+                    construct_type(
                         type_=typing.List[S3ImportStorage],  # type: ignore
                         object_=_response.json(),
                     ),
@@ -95,16 +96,9 @@ class S3Client:
         region_name: typing.Optional[str] = OMIT,
         s3endpoint: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> S3CreateResponse:
+    ) -> S3ImportStorage:
         """
-
-        Create a new source storage connection to a S3 bucket.
-
-        For information about the required fields and prerequisites, see [Amazon S3](https://labelstud.io/guide/storage#Amazon-S3) in the Label Studio documentation.
-
-        <Info>Ensure you configure CORS before adding cloud storage. This ensures you will be able to see the content of the data rather than just a link.</Info>
-
-        <Tip>After you add the storage, you should validate the connection before attempting to sync your data. Your data will not be imported until you [sync your connection](sync).</Tip>
+        Create new S3 import storage
 
         Parameters
         ----------
@@ -161,7 +155,7 @@ class S3Client:
 
         Returns
         -------
-        S3CreateResponse
+        S3ImportStorage
 
 
         Examples
@@ -203,9 +197,9 @@ class S3Client:
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    S3CreateResponse,
-                    parse_obj_as(
-                        type_=S3CreateResponse,  # type: ignore
+                    S3ImportStorage,
+                    construct_type(
+                        type_=S3ImportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -214,148 +208,13 @@ class S3Client:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def validate(
-        self,
-        *,
-        id: typing.Optional[int] = OMIT,
-        regex_filter: typing.Optional[str] = OMIT,
-        use_blob_urls: typing.Optional[bool] = OMIT,
-        presign: typing.Optional[bool] = OMIT,
-        presign_ttl: typing.Optional[int] = OMIT,
-        recursive_scan: typing.Optional[bool] = OMIT,
-        title: typing.Optional[str] = OMIT,
-        description: typing.Optional[str] = OMIT,
-        project: typing.Optional[int] = OMIT,
-        bucket: typing.Optional[str] = OMIT,
-        prefix: typing.Optional[str] = OMIT,
-        aws_access_key_id: typing.Optional[str] = OMIT,
-        aws_secret_access_key: typing.Optional[str] = OMIT,
-        aws_session_token: typing.Optional[str] = OMIT,
-        aws_sse_kms_key_id: typing.Optional[str] = OMIT,
-        region_name: typing.Optional[str] = OMIT,
-        s3endpoint: typing.Optional[str] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> None:
-        """
-
-        Validate a specific S3 import storage connection. This is useful to ensure that the storage configuration settings are correct and operational before attempting to import data.
-
-        Parameters
-        ----------
-        id : typing.Optional[int]
-            Storage ID. If set, storage with specified ID will be updated
-
-        regex_filter : typing.Optional[str]
-            Cloud storage regex for filtering objects. You must specify it otherwise no objects will be imported.
-
-        use_blob_urls : typing.Optional[bool]
-            Interpret objects as BLOBs and generate URLs. For example, if your bucket contains images, you can use this option to generate URLs for these images. If set to False, it will read the content of the file and load it into Label Studio.
-
-        presign : typing.Optional[bool]
-            Presign URLs for download
-
-        presign_ttl : typing.Optional[int]
-            Presign TTL in minutes
-
-        recursive_scan : typing.Optional[bool]
-            Scan recursively
-
-        title : typing.Optional[str]
-            Storage title
-
-        description : typing.Optional[str]
-            Storage description
-
-        project : typing.Optional[int]
-            Project ID
-
-        bucket : typing.Optional[str]
-            S3 bucket name
-
-        prefix : typing.Optional[str]
-            S3 bucket prefix
-
-        aws_access_key_id : typing.Optional[str]
-            AWS_ACCESS_KEY_ID
-
-        aws_secret_access_key : typing.Optional[str]
-            AWS_SECRET_ACCESS_KEY
-
-        aws_session_token : typing.Optional[str]
-            AWS_SESSION_TOKEN
-
-        aws_sse_kms_key_id : typing.Optional[str]
-            AWS SSE KMS Key ID
-
-        region_name : typing.Optional[str]
-            AWS Region
-
-        s3endpoint : typing.Optional[str]
-            S3 Endpoint
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        from label_studio_sdk import LabelStudio
-
-        client = LabelStudio(
-            api_key="YOUR_API_KEY",
-        )
-        client.import_storage.s3.validate()
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            "api/storages/s3/validate",
-            method="POST",
-            json={
-                "id": id,
-                "regex_filter": regex_filter,
-                "use_blob_urls": use_blob_urls,
-                "presign": presign,
-                "presign_ttl": presign_ttl,
-                "recursive_scan": recursive_scan,
-                "title": title,
-                "description": description,
-                "project": project,
-                "bucket": bucket,
-                "prefix": prefix,
-                "aws_access_key_id": aws_access_key_id,
-                "aws_secret_access_key": aws_secret_access_key,
-                "aws_session_token": aws_session_token,
-                "aws_sse_kms_key_id": aws_sse_kms_key_id,
-                "region_name": region_name,
-                "s3_endpoint": s3endpoint,
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
     def get(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> S3ImportStorage:
         """
-
-        Get a specific S3 import storage connection. You will need to provide the import storage ID. You can find this using [List import storages](list).
-
-        For more information about working with external storage, see [Sync data from external storage](https://labelstud.io/guide/storage).
+        Get a specific S3 import storage connection.
 
         Parameters
         ----------
         id : int
-            A unique integer value identifying this s3 import storage.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -385,7 +244,7 @@ class S3Client:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
                     S3ImportStorage,
-                    parse_obj_as(
+                    construct_type(
                         type_=S3ImportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
@@ -397,17 +256,11 @@ class S3Client:
 
     def delete(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
-
-        Delete a specific S3 import storage connection. You will need to provide the import storage ID. You can find this using [List import storages](list).
-
-        Deleting a source storage connection does not affect tasks with synced data in Label Studio. The sync process is designed to import new or updated tasks from the connected storage into the project, but it does not track deletions of files from the storage. Therefore, if you remove the external storage connection, the tasks that were created from that storage will remain in the project.
-
-        If you want to remove the tasks that were synced from the external storage, you will need to delete them manually from within the Label Studio UI or use the [Delete tasks](../../tasks/delete-all-tasks) API.
+        Delete a specific S3 import storage connection.
 
         Parameters
         ----------
         id : int
-            A unique integer value identifying this s3 import storage.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -461,17 +314,13 @@ class S3Client:
         region_name: typing.Optional[str] = OMIT,
         s3endpoint: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> S3UpdateResponse:
+    ) -> S3ImportStorage:
         """
-
-        Update a specific S3 import storage connection. You will need to provide the import storage ID. You can find this using [List import storages](list).
-
-        For more information about working with external storage, see [Sync data from external storage](https://labelstud.io/guide/storage).
+        Update a specific S3 import storage connection.
 
         Parameters
         ----------
         id : int
-            A unique integer value identifying this s3 import storage.
 
         regex_filter : typing.Optional[str]
             Cloud storage regex for filtering objects. You must specify it otherwise no objects will be imported.
@@ -526,7 +375,7 @@ class S3Client:
 
         Returns
         -------
-        S3UpdateResponse
+        S3ImportStorage
 
 
         Examples
@@ -570,9 +419,9 @@ class S3Client:
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    S3UpdateResponse,
-                    parse_obj_as(
-                        type_=S3UpdateResponse,  # type: ignore
+                    S3ImportStorage,
+                    construct_type(
+                        type_=S3ImportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -583,12 +432,7 @@ class S3Client:
 
     def sync(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> S3ImportStorage:
         """
-
-        Sync tasks from an S3 import storage connection. You will need to provide the import storage ID. You can find this using [List import storages](list).
-
-        Sync operations with external buckets only go one way. They either create tasks from objects in the bucket (source/import storage) or push annotations to the output bucket (export/target storage). Changing something on the bucket side doesn’t guarantee consistency in results.
-
-        <Note>Before proceeding, you should review [How sync operations work - Source storage](https://labelstud.io/guide/storage#Source-storage) to ensure that your data remains secure and private.</Note>
+        Sync tasks from an S3 import storage connection.
 
         Parameters
         ----------
@@ -623,7 +467,7 @@ class S3Client:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
                     S3ImportStorage,
-                    parse_obj_as(
+                    construct_type(
                         type_=S3ImportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
@@ -633,77 +477,10 @@ class S3Client:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-
-class AsyncS3Client:
-    def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._client_wrapper = client_wrapper
-
-    async def list(
-        self, *, project: typing.Optional[int] = None, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.List[S3ImportStorage]:
-        """
-
-        You can connect your S3 bucket to Label Studio as a source storage or target storage. Use this API request to get a list of all Google import (source) storage connections for a specific project.
-
-        The project ID can be found in the URL when viewing the project in Label Studio, or you can retrieve all project IDs using [List all projects](../projects/list).
-
-        For more information about working with external storage, see [Sync data from external storage](https://labelstud.io/guide/storage).
-
-        Parameters
-        ----------
-        project : typing.Optional[int]
-            Project ID
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        typing.List[S3ImportStorage]
-
-
-        Examples
-        --------
-        import asyncio
-
-        from label_studio_sdk import AsyncLabelStudio
-
-        client = AsyncLabelStudio(
-            api_key="YOUR_API_KEY",
-        )
-
-
-        async def main() -> None:
-            await client.import_storage.s3.list()
-
-
-        asyncio.run(main())
-        """
-        _response = await self._client_wrapper.httpx_client.request(
-            "api/storages/s3/",
-            method="GET",
-            params={
-                "project": project,
-            },
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    typing.List[S3ImportStorage],
-                    parse_obj_as(
-                        type_=typing.List[S3ImportStorage],  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
-    async def create(
+    def validate(
         self,
         *,
+        id: typing.Optional[int] = OMIT,
         regex_filter: typing.Optional[str] = OMIT,
         use_blob_urls: typing.Optional[bool] = OMIT,
         presign: typing.Optional[bool] = OMIT,
@@ -721,19 +498,15 @@ class AsyncS3Client:
         region_name: typing.Optional[str] = OMIT,
         s3endpoint: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> S3CreateResponse:
+    ) -> None:
         """
-
-        Create a new source storage connection to a S3 bucket.
-
-        For information about the required fields and prerequisites, see [Amazon S3](https://labelstud.io/guide/storage#Amazon-S3) in the Label Studio documentation.
-
-        <Info>Ensure you configure CORS before adding cloud storage. This ensures you will be able to see the content of the data rather than just a link.</Info>
-
-        <Tip>After you add the storage, you should validate the connection before attempting to sync your data. Your data will not be imported until you [sync your connection](sync).</Tip>
+        Validate a specific S3 import storage connection.
 
         Parameters
         ----------
+        id : typing.Optional[int]
+            Storage ID. If set, storage with specified ID will be updated
+
         regex_filter : typing.Optional[str]
             Cloud storage regex for filtering objects. You must specify it otherwise no objects will be imported.
 
@@ -787,30 +560,22 @@ class AsyncS3Client:
 
         Returns
         -------
-        S3CreateResponse
-
+        None
 
         Examples
         --------
-        import asyncio
-
-        from label_studio_sdk import AsyncLabelStudio
+        from label_studio_sdk import LabelStudio
 
-        client = AsyncLabelStudio(
+        client = LabelStudio(
             api_key="YOUR_API_KEY",
         )
-
-
-        async def main() -> None:
-            await client.import_storage.s3.create()
-
-
-        asyncio.run(main())
+        client.import_storage.s3.validate()
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "api/storages/s3/",
+        _response = self._client_wrapper.httpx_client.request(
+            "api/storages/s3/validate",
             method="POST",
             json={
+                "id": id,
                 "regex_filter": regex_filter,
                 "use_blob_urls": use_blob_urls,
                 "presign": presign,
@@ -834,12 +599,77 @@ class AsyncS3Client:
             request_options=request_options,
             omit=OMIT,
         )
+        try:
+            if 200 <= _response.status_code < 300:
+                return
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+
+class AsyncS3Client:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list(
+        self,
+        *,
+        ordering: typing.Optional[str] = None,
+        project: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[S3ImportStorage]:
+        """
+        Get a list of all S3 import storage connections.
+
+        Parameters
+        ----------
+        ordering : typing.Optional[str]
+            Which field to use when ordering the results.
+
+        project : typing.Optional[int]
+            Project ID
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[S3ImportStorage]
+
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.import_storage.s3.list()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/storages/s3/",
+            method="GET",
+            params={
+                "ordering": ordering,
+                "project": project,
+            },
+            request_options=request_options,
+        )
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    S3CreateResponse,
-                    parse_obj_as(
-                        type_=S3CreateResponse,  # type: ignore
+                    typing.List[S3ImportStorage],
+                    construct_type(
+                        type_=typing.List[S3ImportStorage],  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -848,10 +678,9 @@ class AsyncS3Client:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def validate(
+    async def create(
         self,
         *,
-        id: typing.Optional[int] = OMIT,
         regex_filter: typing.Optional[str] = OMIT,
         use_blob_urls: typing.Optional[bool] = OMIT,
         presign: typing.Optional[bool] = OMIT,
@@ -869,16 +698,12 @@ class AsyncS3Client:
         region_name: typing.Optional[str] = OMIT,
         s3endpoint: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> None:
+    ) -> S3ImportStorage:
         """
-
-        Validate a specific S3 import storage connection. This is useful to ensure that the storage configuration settings are correct and operational before attempting to import data.
+        Create new S3 import storage
 
         Parameters
         ----------
-        id : typing.Optional[int]
-            Storage ID. If set, storage with specified ID will be updated
-
         regex_filter : typing.Optional[str]
             Cloud storage regex for filtering objects. You must specify it otherwise no objects will be imported.
 
@@ -932,7 +757,8 @@ class AsyncS3Client:
 
         Returns
         -------
-        None
+        S3ImportStorage
+
 
         Examples
         --------
@@ -946,16 +772,15 @@ class AsyncS3Client:
 
 
         async def main() -> None:
-            await client.import_storage.s3.validate()
+            await client.import_storage.s3.create()
 
 
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            "api/storages/s3/validate",
+            "api/storages/s3/",
             method="POST",
             json={
-                "id": id,
                 "regex_filter": regex_filter,
                 "use_blob_urls": use_blob_urls,
                 "presign": presign,
@@ -981,7 +806,13 @@ class AsyncS3Client:
         )
         try:
             if 200 <= _response.status_code < 300:
-                return
+                return typing.cast(
+                    S3ImportStorage,
+                    construct_type(
+                        type_=S3ImportStorage,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
@@ -989,15 +820,11 @@ class AsyncS3Client:
 
     async def get(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> S3ImportStorage:
         """
-
-        Get a specific S3 import storage connection. You will need to provide the import storage ID. You can find this using [List import storages](list).
-
-        For more information about working with external storage, see [Sync data from external storage](https://labelstud.io/guide/storage).
+        Get a specific S3 import storage connection.
 
         Parameters
         ----------
         id : int
-            A unique integer value identifying this s3 import storage.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1035,7 +862,7 @@ class AsyncS3Client:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
                     S3ImportStorage,
-                    parse_obj_as(
+                    construct_type(
                         type_=S3ImportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
@@ -1047,17 +874,11 @@ class AsyncS3Client:
 
     async def delete(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
-
-        Delete a specific S3 import storage connection. You will need to provide the import storage ID. You can find this using [List import storages](list).
-
-        Deleting a source storage connection does not affect tasks with synced data in Label Studio. The sync process is designed to import new or updated tasks from the connected storage into the project, but it does not track deletions of files from the storage. Therefore, if you remove the external storage connection, the tasks that were created from that storage will remain in the project.
-
-        If you want to remove the tasks that were synced from the external storage, you will need to delete them manually from within the Label Studio UI or use the [Delete tasks](../../tasks/delete-all-tasks) API.
+        Delete a specific S3 import storage connection.
 
         Parameters
         ----------
         id : int
-            A unique integer value identifying this s3 import storage.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1119,17 +940,13 @@ class AsyncS3Client:
         region_name: typing.Optional[str] = OMIT,
         s3endpoint: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> S3UpdateResponse:
+    ) -> S3ImportStorage:
         """
-
-        Update a specific S3 import storage connection. You will need to provide the import storage ID. You can find this using [List import storages](list).
-
-        For more information about working with external storage, see [Sync data from external storage](https://labelstud.io/guide/storage).
+        Update a specific S3 import storage connection.
 
         Parameters
         ----------
         id : int
-            A unique integer value identifying this s3 import storage.
 
         regex_filter : typing.Optional[str]
             Cloud storage regex for filtering objects. You must specify it otherwise no objects will be imported.
@@ -1184,7 +1001,7 @@ class AsyncS3Client:
 
         Returns
         -------
-        S3UpdateResponse
+        S3ImportStorage
 
 
         Examples
@@ -1236,9 +1053,9 @@ class AsyncS3Client:
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    S3UpdateResponse,
-                    parse_obj_as(
-                        type_=S3UpdateResponse,  # type: ignore
+                    S3ImportStorage,
+                    construct_type(
+                        type_=S3ImportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -1249,12 +1066,7 @@ class AsyncS3Client:
 
     async def sync(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> S3ImportStorage:
         """
-
-        Sync tasks from an S3 import storage connection. You will need to provide the import storage ID. You can find this using [List import storages](list).
-
-        Sync operations with external buckets only go one way. They either create tasks from objects in the bucket (source/import storage) or push annotations to the output bucket (export/target storage). Changing something on the bucket side doesn’t guarantee consistency in results.
-
-        <Note>Before proceeding, you should review [How sync operations work - Source storage](https://labelstud.io/guide/storage#Source-storage) to ensure that your data remains secure and private.</Note>
+        Sync tasks from an S3 import storage connection.
 
         Parameters
         ----------
@@ -1297,7 +1109,7 @@ class AsyncS3Client:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
                     S3ImportStorage,
-                    parse_obj_as(
+                    construct_type(
                         type_=S3ImportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
@@ -1306,3 +1118,141 @@ class AsyncS3Client:
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def validate(
+        self,
+        *,
+        id: typing.Optional[int] = OMIT,
+        regex_filter: typing.Optional[str] = OMIT,
+        use_blob_urls: typing.Optional[bool] = OMIT,
+        presign: typing.Optional[bool] = OMIT,
+        presign_ttl: typing.Optional[int] = OMIT,
+        recursive_scan: typing.Optional[bool] = OMIT,
+        title: typing.Optional[str] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        project: typing.Optional[int] = OMIT,
+        bucket: typing.Optional[str] = OMIT,
+        prefix: typing.Optional[str] = OMIT,
+        aws_access_key_id: typing.Optional[str] = OMIT,
+        aws_secret_access_key: typing.Optional[str] = OMIT,
+        aws_session_token: typing.Optional[str] = OMIT,
+        aws_sse_kms_key_id: typing.Optional[str] = OMIT,
+        region_name: typing.Optional[str] = OMIT,
+        s3endpoint: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> None:
+        """
+        Validate a specific S3 import storage connection.
+
+        Parameters
+        ----------
+        id : typing.Optional[int]
+            Storage ID. If set, storage with specified ID will be updated
+
+        regex_filter : typing.Optional[str]
+            Cloud storage regex for filtering objects. You must specify it otherwise no objects will be imported.
+
+        use_blob_urls : typing.Optional[bool]
+            Interpret objects as BLOBs and generate URLs. For example, if your bucket contains images, you can use this option to generate URLs for these images. If set to False, it will read the content of the file and load it into Label Studio.
+
+        presign : typing.Optional[bool]
+            Presign URLs for download
+
+        presign_ttl : typing.Optional[int]
+            Presign TTL in minutes
+
+        recursive_scan : typing.Optional[bool]
+            Scan recursively
+
+        title : typing.Optional[str]
+            Storage title
+
+        description : typing.Optional[str]
+            Storage description
+
+        project : typing.Optional[int]
+            Project ID
+
+        bucket : typing.Optional[str]
+            S3 bucket name
+
+        prefix : typing.Optional[str]
+            S3 bucket prefix
+
+        aws_access_key_id : typing.Optional[str]
+            AWS_ACCESS_KEY_ID
+
+        aws_secret_access_key : typing.Optional[str]
+            AWS_SECRET_ACCESS_KEY
+
+        aws_session_token : typing.Optional[str]
+            AWS_SESSION_TOKEN
+
+        aws_sse_kms_key_id : typing.Optional[str]
+            AWS SSE KMS Key ID
+
+        region_name : typing.Optional[str]
+            AWS Region
+
+        s3endpoint : typing.Optional[str]
+            S3 Endpoint
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.import_storage.s3.validate()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/storages/s3/validate",
+            method="POST",
+            json={
+                "id": id,
+                "regex_filter": regex_filter,
+                "use_blob_urls": use_blob_urls,
+                "presign": presign,
+                "presign_ttl": presign_ttl,
+                "recursive_scan": recursive_scan,
+                "title": title,
+                "description": description,
+                "project": project,
+                "bucket": bucket,
+                "prefix": prefix,
+                "aws_access_key_id": aws_access_key_id,
+                "aws_secret_access_key": aws_secret_access_key,
+                "aws_session_token": aws_session_token,
+                "aws_sse_kms_key_id": aws_sse_kms_key_id,
+                "region_name": region_name,
+                "s3_endpoint": s3endpoint,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)