label-studio-sdk 1.0.7__py3-none-any.whl → 1.0.10__py3-none-any.whl

label_studio_sdk/annotations/client.py

@@ -1,15 +1,17 @@
 # This file was auto-generated by Fern from our API Definition.
 
 import typing
-from json.decoder import JSONDecodeError
-
-from ..core.api_error import ApiError
-from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
-from ..core.jsonable_encoder import jsonable_encoder
-from ..core.pydantic_utilities import pydantic_v1
+from ..core.client_wrapper import SyncClientWrapper
 from ..core.request_options import RequestOptions
 from ..types.annotation import Annotation
+from ..core.jsonable_encoder import jsonable_encoder
+from ..core.pydantic_utilities import parse_obj_as
+from json.decoder import JSONDecodeError
+from ..core.api_error import ApiError
+from .types.annotations_create_bulk_request_selected_items import AnnotationsCreateBulkRequestSelectedItems
 from .types.annotations_create_bulk_response_item import AnnotationsCreateBulkResponseItem
+from ..core.serialization import convert_and_respect_annotation_metadata
+from ..core.client_wrapper import AsyncClientWrapper
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -21,6 +23,7 @@ class AnnotationsClient:
 
     def get(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> Annotation:
         """
+
         Tasks can have multiple annotations. Use this call to retrieve a specific annotation using its ID.
 
         You can find the ID in the Label Studio UI listed at the top of the annotation in its tab. It is also listed in the History panel when viewing the annotation. Or you can use [Get all task annotations](list) to find all annotation IDs.
@@ -40,7 +43,7 @@ class AnnotationsClient:
 
         Examples
         --------
-        from label_studio_sdk.client import LabelStudio
+        from label_studio_sdk import LabelStudio
 
         client = LabelStudio(
             api_key="YOUR_API_KEY",
@@ -50,11 +53,19 @@ class AnnotationsClient:
         )
         """
         _response = self._client_wrapper.httpx_client.request(
-            f"api/annotations/{jsonable_encoder(id)}/", method="GET", request_options=request_options
+            f"api/annotations/{jsonable_encoder(id)}/",
+            method="GET",
+            request_options=request_options,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return pydantic_v1.parse_obj_as(Annotation, _response.json())  # type: ignore
+                return typing.cast(
+                    Annotation,
+                    parse_obj_as(
+                        type_=Annotation,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
@@ -62,6 +73,7 @@ class AnnotationsClient:
 
     def delete(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
+
         Delete an annotation.
 
         <Warning>This action can't be undone!</Warning>
@@ -82,7 +94,7 @@ class AnnotationsClient:
 
         Examples
         --------
-        from label_studio_sdk.client import LabelStudio
+        from label_studio_sdk import LabelStudio
 
         client = LabelStudio(
             api_key="YOUR_API_KEY",
@@ -92,7 +104,9 @@ class AnnotationsClient:
         )
         """
         _response = self._client_wrapper.httpx_client.request(
-            f"api/annotations/{jsonable_encoder(id)}/", method="DELETE", request_options=request_options
+            f"api/annotations/{jsonable_encoder(id)}/",
+            method="DELETE",
+            request_options=request_options,
         )
         try:
             if 200 <= _response.status_code < 300:
@@ -106,7 +120,7 @@ class AnnotationsClient:
         self,
         id: int,
         *,
-        result: typing.Optional[typing.Sequence[typing.Dict[str, typing.Any]]] = OMIT,
+        result: typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]] = OMIT,
         task: typing.Optional[int] = OMIT,
         project: typing.Optional[int] = OMIT,
         completed_by: typing.Optional[int] = OMIT,
@@ -117,6 +131,7 @@ class AnnotationsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Annotation:
         """
+
         Update attributes for an existing annotation.
 
         You will need to supply the annotation's unique ID. You can find the ID in the Label Studio UI listed at the top of the annotation in its tab. It is also listed in the History panel when viewing the annotation. Or you can use [Get all task annotations](list) to find all annotation IDs.
@@ -128,7 +143,7 @@ class AnnotationsClient:
         id : int
             A unique integer value identifying this annotation.
 
-        result : typing.Optional[typing.Sequence[typing.Dict[str, typing.Any]]]
+        result : typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]]
             Labeling result in JSON format. Read more about the format in [the Label Studio documentation.](https://labelstud.io/guide/task_format)
 
         task : typing.Optional[int]
@@ -162,7 +177,7 @@ class AnnotationsClient:
 
         Examples
         --------
-        from label_studio_sdk.client import LabelStudio
+        from label_studio_sdk import LabelStudio
 
         client = LabelStudio(
             api_key="YOUR_API_KEY",
@@ -204,12 +219,21 @@ class AnnotationsClient:
                 "ground_truth": ground_truth,
                 "lead_time": lead_time,
             },
+            headers={
+                "content-type": "application/json",
+            },
             request_options=request_options,
             omit=OMIT,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return pydantic_v1.parse_obj_as(Annotation, _response.json())  # type: ignore
+                return typing.cast(
+                    Annotation,
+                    parse_obj_as(
+                        type_=Annotation,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
@@ -217,6 +241,7 @@ class AnnotationsClient:
 
     def list(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[Annotation]:
         """
+
         List all annotations for a task.
 
         You will need to supply the task ID. You can find this in Label Studio by opening a task and checking the URL. It is also listed at the top of the labeling interface. Or you can use [Get tasks list](../tasks/list).
@@ -236,7 +261,7 @@ class AnnotationsClient:
 
         Examples
         --------
-        from label_studio_sdk.client import LabelStudio
+        from label_studio_sdk import LabelStudio
 
         client = LabelStudio(
             api_key="YOUR_API_KEY",
@@ -246,11 +271,19 @@ class AnnotationsClient:
         )
         """
         _response = self._client_wrapper.httpx_client.request(
-            f"api/tasks/{jsonable_encoder(id)}/annotations/", method="GET", request_options=request_options
+            f"api/tasks/{jsonable_encoder(id)}/annotations/",
+            method="GET",
+            request_options=request_options,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return pydantic_v1.parse_obj_as(typing.List[Annotation], _response.json())  # type: ignore
+                return typing.cast(
+                    typing.List[Annotation],
+                    parse_obj_as(
+                        type_=typing.List[Annotation],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
@@ -260,7 +293,7 @@ class AnnotationsClient:
         self,
         id: int,
         *,
-        result: typing.Optional[typing.Sequence[typing.Dict[str, typing.Any]]] = OMIT,
+        result: typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]] = OMIT,
         task: typing.Optional[int] = OMIT,
         project: typing.Optional[int] = OMIT,
         completed_by: typing.Optional[int] = OMIT,
@@ -271,10 +304,12 @@ class AnnotationsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Annotation:
         """
+
         Add annotations to a task like an annotator does.
 
         You will need to supply the task ID. You can find this in Label Studio by opening a task and checking the URL. It is also listed at the top of the labeling interface. Or you can use [Get tasks list](../tasks/list).
 
+
         The content of the result field depends on your labeling configuration. For example, send the following data as part of your POST
         request to send an empty annotation with the ID of the user who completed the task:
 
@@ -294,7 +329,7 @@ class AnnotationsClient:
         id : int
             Task ID
 
-        result : typing.Optional[typing.Sequence[typing.Dict[str, typing.Any]]]
+        result : typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]]
             Labeling result in JSON format. Read more about the format in [the Label Studio documentation.](https://labelstud.io/guide/task_format)
 
         task : typing.Optional[int]
@@ -328,7 +363,7 @@ class AnnotationsClient:
 
         Examples
         --------
-        from label_studio_sdk.client import LabelStudio
+        from label_studio_sdk import LabelStudio
 
         client = LabelStudio(
             api_key="YOUR_API_KEY",
@@ -370,12 +405,21 @@ class AnnotationsClient:
                 "ground_truth": ground_truth,
                 "lead_time": lead_time,
             },
+            headers={
+                "content-type": "application/json",
+            },
             request_options=request_options,
             omit=OMIT,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return pydantic_v1.parse_obj_as(Annotation, _response.json())  # type: ignore
+                return typing.cast(
+                    Annotation,
+                    parse_obj_as(
+                        type_=Annotation,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
@@ -385,9 +429,10 @@ class AnnotationsClient:
         self,
         *,
         tasks: typing.Optional[typing.Sequence[int]] = OMIT,
+        selected_items: typing.Optional[AnnotationsCreateBulkRequestSelectedItems] = OMIT,
         lead_time: typing.Optional[float] = OMIT,
         project: typing.Optional[int] = OMIT,
-        result: typing.Optional[typing.Dict[str, typing.Any]] = OMIT,
+        result: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[AnnotationsCreateBulkResponseItem]:
         """
@@ -397,11 +442,13 @@ class AnnotationsClient:
         ----------
         tasks : typing.Optional[typing.Sequence[int]]
 
+        selected_items : typing.Optional[AnnotationsCreateBulkRequestSelectedItems]
+
         lead_time : typing.Optional[float]
 
         project : typing.Optional[int]
 
-        result : typing.Optional[typing.Dict[str, typing.Any]]
+        result : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -413,7 +460,7 @@ class AnnotationsClient:
 
         Examples
         --------
-        from label_studio_sdk.client import LabelStudio
+        from label_studio_sdk import LabelStudio
 
         client = LabelStudio(
             api_key="YOUR_API_KEY",
@@ -423,13 +470,30 @@ class AnnotationsClient:
         _response = self._client_wrapper.httpx_client.request(
             "api/annotations/bulk",
             method="POST",
-            json={"tasks": tasks, "lead_time": lead_time, "project": project, "result": result},
+            json={
+                "tasks": tasks,
+                "selectedItems": convert_and_respect_annotation_metadata(
+                    object_=selected_items, annotation=AnnotationsCreateBulkRequestSelectedItems, direction="write"
+                ),
+                "lead_time": lead_time,
+                "project": project,
+                "result": result,
+            },
+            headers={
+                "content-type": "application/json",
+            },
             request_options=request_options,
             omit=OMIT,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return pydantic_v1.parse_obj_as(typing.List[AnnotationsCreateBulkResponseItem], _response.json())  # type: ignore
+                return typing.cast(
+                    typing.List[AnnotationsCreateBulkResponseItem],
+                    parse_obj_as(
+                        type_=typing.List[AnnotationsCreateBulkResponseItem],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
@@ -442,6 +506,7 @@ class AsyncAnnotationsClient:
 
     async def get(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> Annotation:
         """
+
         Tasks can have multiple annotations. Use this call to retrieve a specific annotation using its ID.
 
         You can find the ID in the Label Studio UI listed at the top of the annotation in its tab. It is also listed in the History panel when viewing the annotation. Or you can use [Get all task annotations](list) to find all annotation IDs.
@@ -461,21 +526,37 @@ class AsyncAnnotationsClient:
 
         Examples
         --------
-        from label_studio_sdk.client import AsyncLabelStudio
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
 
         client = AsyncLabelStudio(
             api_key="YOUR_API_KEY",
         )
-        await client.annotations.get(
-            id=1,
-        )
+
+
+        async def main() -> None:
+            await client.annotations.get(
+                id=1,
+            )
+
+
+        asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            f"api/annotations/{jsonable_encoder(id)}/", method="GET", request_options=request_options
+            f"api/annotations/{jsonable_encoder(id)}/",
+            method="GET",
+            request_options=request_options,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return pydantic_v1.parse_obj_as(Annotation, _response.json())  # type: ignore
+                return typing.cast(
+                    Annotation,
+                    parse_obj_as(
+                        type_=Annotation,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
@@ -483,6 +564,7 @@ class AsyncAnnotationsClient:
 
     async def delete(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
+
         Delete an annotation.
 
         <Warning>This action can't be undone!</Warning>
@@ -503,17 +585,27 @@ class AsyncAnnotationsClient:
 
         Examples
         --------
-        from label_studio_sdk.client import AsyncLabelStudio
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
 
         client = AsyncLabelStudio(
             api_key="YOUR_API_KEY",
         )
-        await client.annotations.delete(
-            id=1,
-        )
+
+
+        async def main() -> None:
+            await client.annotations.delete(
+                id=1,
+            )
+
+
+        asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            f"api/annotations/{jsonable_encoder(id)}/", method="DELETE", request_options=request_options
+            f"api/annotations/{jsonable_encoder(id)}/",
+            method="DELETE",
+            request_options=request_options,
         )
         try:
             if 200 <= _response.status_code < 300:
@@ -527,7 +619,7 @@ class AsyncAnnotationsClient:
         self,
         id: int,
         *,
-        result: typing.Optional[typing.Sequence[typing.Dict[str, typing.Any]]] = OMIT,
+        result: typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]] = OMIT,
         task: typing.Optional[int] = OMIT,
         project: typing.Optional[int] = OMIT,
         completed_by: typing.Optional[int] = OMIT,
@@ -538,6 +630,7 @@ class AsyncAnnotationsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Annotation:
         """
+
         Update attributes for an existing annotation.
 
         You will need to supply the annotation's unique ID. You can find the ID in the Label Studio UI listed at the top of the annotation in its tab. It is also listed in the History panel when viewing the annotation. Or you can use [Get all task annotations](list) to find all annotation IDs.
@@ -549,7 +642,7 @@ class AsyncAnnotationsClient:
         id : int
             A unique integer value identifying this annotation.
 
-        result : typing.Optional[typing.Sequence[typing.Dict[str, typing.Any]]]
+        result : typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]]
             Labeling result in JSON format. Read more about the format in [the Label Studio documentation.](https://labelstud.io/guide/task_format)
 
         task : typing.Optional[int]
@@ -583,34 +676,42 @@ class AsyncAnnotationsClient:
 
         Examples
         --------
-        from label_studio_sdk.client import AsyncLabelStudio
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
 
         client = AsyncLabelStudio(
             api_key="YOUR_API_KEY",
         )
-        await client.annotations.update(
-            id=1,
-            result=[
-                {
-                    "original_width": 1920,
-                    "original_height": 1080,
-                    "image_rotation": 0,
-                    "from_name": "bboxes",
-                    "to_name": "image",
-                    "type": "rectanglelabels",
-                    "value": {
-                        "x": 20,
-                        "y": 30,
-                        "width": 50,
-                        "height": 60,
-                        "rotation": 0,
-                        "values": {"rectanglelabels": ["Person"]},
-                    },
-                }
-            ],
-            was_cancelled=False,
-            ground_truth=True,
-        )
+
+
+        async def main() -> None:
+            await client.annotations.update(
+                id=1,
+                result=[
+                    {
+                        "original_width": 1920,
+                        "original_height": 1080,
+                        "image_rotation": 0,
+                        "from_name": "bboxes",
+                        "to_name": "image",
+                        "type": "rectanglelabels",
+                        "value": {
+                            "x": 20,
+                            "y": 30,
+                            "width": 50,
+                            "height": 60,
+                            "rotation": 0,
+                            "values": {"rectanglelabels": ["Person"]},
+                        },
+                    }
+                ],
+                was_cancelled=False,
+                ground_truth=True,
+            )
+
+
+        asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
             f"api/annotations/{jsonable_encoder(id)}/",
@@ -625,12 +726,21 @@ class AsyncAnnotationsClient:
                 "ground_truth": ground_truth,
                 "lead_time": lead_time,
             },
+            headers={
+                "content-type": "application/json",
+            },
             request_options=request_options,
             omit=OMIT,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return pydantic_v1.parse_obj_as(Annotation, _response.json())  # type: ignore
+                return typing.cast(
+                    Annotation,
+                    parse_obj_as(
+                        type_=Annotation,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
@@ -640,6 +750,7 @@ class AsyncAnnotationsClient:
         self, id: int, *, request_options: typing.Optional[RequestOptions] = None
     ) -> typing.List[Annotation]:
         """
+
         List all annotations for a task.
 
         You will need to supply the task ID. You can find this in Label Studio by opening a task and checking the URL. It is also listed at the top of the labeling interface. Or you can use [Get tasks list](../tasks/list).
@@ -659,21 +770,37 @@ class AsyncAnnotationsClient:
 
         Examples
         --------
-        from label_studio_sdk.client import AsyncLabelStudio
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
 
         client = AsyncLabelStudio(
             api_key="YOUR_API_KEY",
         )
-        await client.annotations.list(
-            id=1,
-        )
+
+
+        async def main() -> None:
+            await client.annotations.list(
+                id=1,
+            )
+
+
+        asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            f"api/tasks/{jsonable_encoder(id)}/annotations/", method="GET", request_options=request_options
+            f"api/tasks/{jsonable_encoder(id)}/annotations/",
+            method="GET",
+            request_options=request_options,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return pydantic_v1.parse_obj_as(typing.List[Annotation], _response.json())  # type: ignore
+                return typing.cast(
+                    typing.List[Annotation],
+                    parse_obj_as(
+                        type_=typing.List[Annotation],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
@@ -683,7 +810,7 @@ class AsyncAnnotationsClient:
         self,
         id: int,
         *,
-        result: typing.Optional[typing.Sequence[typing.Dict[str, typing.Any]]] = OMIT,
+        result: typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]] = OMIT,
         task: typing.Optional[int] = OMIT,
         project: typing.Optional[int] = OMIT,
         completed_by: typing.Optional[int] = OMIT,
@@ -694,10 +821,12 @@ class AsyncAnnotationsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Annotation:
         """
+
         Add annotations to a task like an annotator does.
 
         You will need to supply the task ID. You can find this in Label Studio by opening a task and checking the URL. It is also listed at the top of the labeling interface. Or you can use [Get tasks list](../tasks/list).
 
+
         The content of the result field depends on your labeling configuration. For example, send the following data as part of your POST
         request to send an empty annotation with the ID of the user who completed the task:
 
@@ -717,7 +846,7 @@ class AsyncAnnotationsClient:
         id : int
             Task ID
 
-        result : typing.Optional[typing.Sequence[typing.Dict[str, typing.Any]]]
+        result : typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]]
             Labeling result in JSON format. Read more about the format in [the Label Studio documentation.](https://labelstud.io/guide/task_format)
 
         task : typing.Optional[int]
@@ -751,34 +880,42 @@ class AsyncAnnotationsClient:
 
         Examples
         --------
-        from label_studio_sdk.client import AsyncLabelStudio
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
 
         client = AsyncLabelStudio(
             api_key="YOUR_API_KEY",
         )
-        await client.annotations.create(
-            id=1,
-            result=[
-                {
-                    "original_width": 1920,
-                    "original_height": 1080,
-                    "image_rotation": 0,
-                    "from_name": "bboxes",
-                    "to_name": "image",
-                    "type": "rectanglelabels",
-                    "value": {
-                        "x": 20,
-                        "y": 30,
-                        "width": 50,
-                        "height": 60,
-                        "rotation": 0,
-                        "values": {"rectanglelabels": ["Person"]},
-                    },
-                }
-            ],
-            was_cancelled=False,
-            ground_truth=True,
-        )
+
+
+        async def main() -> None:
+            await client.annotations.create(
+                id=1,
+                result=[
+                    {
+                        "original_width": 1920,
+                        "original_height": 1080,
+                        "image_rotation": 0,
+                        "from_name": "bboxes",
+                        "to_name": "image",
+                        "type": "rectanglelabels",
+                        "value": {
+                            "x": 20,
+                            "y": 30,
+                            "width": 50,
+                            "height": 60,
+                            "rotation": 0,
+                            "values": {"rectanglelabels": ["Person"]},
+                        },
+                    }
+                ],
+                was_cancelled=False,
+                ground_truth=True,
+            )
+
+
+        asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
             f"api/tasks/{jsonable_encoder(id)}/annotations/",
@@ -793,12 +930,21 @@ class AsyncAnnotationsClient:
                 "ground_truth": ground_truth,
                 "lead_time": lead_time,
             },
+            headers={
+                "content-type": "application/json",
+            },
             request_options=request_options,
             omit=OMIT,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return pydantic_v1.parse_obj_as(Annotation, _response.json())  # type: ignore
+                return typing.cast(
+                    Annotation,
+                    parse_obj_as(
+                        type_=Annotation,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
@@ -808,9 +954,10 @@ class AsyncAnnotationsClient:
         self,
         *,
         tasks: typing.Optional[typing.Sequence[int]] = OMIT,
+        selected_items: typing.Optional[AnnotationsCreateBulkRequestSelectedItems] = OMIT,
         lead_time: typing.Optional[float] = OMIT,
         project: typing.Optional[int] = OMIT,
-        result: typing.Optional[typing.Dict[str, typing.Any]] = OMIT,
+        result: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[AnnotationsCreateBulkResponseItem]:
         """
@@ -820,11 +967,13 @@ class AsyncAnnotationsClient:
         ----------
         tasks : typing.Optional[typing.Sequence[int]]
 
+        selected_items : typing.Optional[AnnotationsCreateBulkRequestSelectedItems]
+
         lead_time : typing.Optional[float]
 
         project : typing.Optional[int]
 
-        result : typing.Optional[typing.Dict[str, typing.Any]]
+        result : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -836,23 +985,48 @@ class AsyncAnnotationsClient:
 
         Examples
         --------
-        from label_studio_sdk.client import AsyncLabelStudio
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
 
         client = AsyncLabelStudio(
             api_key="YOUR_API_KEY",
         )
-        await client.annotations.create_bulk()
+
+
+        async def main() -> None:
+            await client.annotations.create_bulk()
+
+
+        asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
             "api/annotations/bulk",
             method="POST",
-            json={"tasks": tasks, "lead_time": lead_time, "project": project, "result": result},
+            json={
+                "tasks": tasks,
+                "selectedItems": convert_and_respect_annotation_metadata(
+                    object_=selected_items, annotation=AnnotationsCreateBulkRequestSelectedItems, direction="write"
+                ),
+                "lead_time": lead_time,
+                "project": project,
+                "result": result,
+            },
+            headers={
+                "content-type": "application/json",
+            },
             request_options=request_options,
             omit=OMIT,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return pydantic_v1.parse_obj_as(typing.List[AnnotationsCreateBulkResponseItem], _response.json())  # type: ignore
+                return typing.cast(
+                    typing.List[AnnotationsCreateBulkResponseItem],
+                    parse_obj_as(
+                        type_=typing.List[AnnotationsCreateBulkResponseItem],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)