label-studio-sdk 2.0.1__py3-none-any.whl → 2.0.3__py3-none-any.whl

label_studio_sdk/annotations/client.py

@@ -2,19 +2,19 @@
 
 import typing
 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.unchecked_base_model import construct_type
-from json.decoder import JSONDecodeError
-from ..core.api_error import ApiError
-from ..types.selected_items_request import SelectedItemsRequest
 import datetime as dt
 from .types.annotation_bulk_serializer_with_selected_items_request_last_action import (
     AnnotationBulkSerializerWithSelectedItemsRequestLastAction,
 )
+from ..types.selected_items_request import SelectedItemsRequest
+from ..core.request_options import RequestOptions
 from .types.annotations_create_bulk_response_item import AnnotationsCreateBulkResponseItem
 from ..core.serialization import convert_and_respect_annotation_metadata
+from ..core.unchecked_base_model import construct_type
+from json.decoder import JSONDecodeError
+from ..core.api_error import ApiError
+from ..types.annotation import Annotation
+from ..core.jsonable_encoder import jsonable_encoder
 from ..core.client_wrapper import AsyncClientWrapper
 
 # this is used as the default value for optional parameters
@@ -25,6 +25,161 @@ class AnnotationsClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
         self._client_wrapper = client_wrapper
 
+    def create_bulk(
+        self,
+        *,
+        bulk_created: typing.Optional[bool] = OMIT,
+        completed_by: typing.Optional[int] = OMIT,
+        draft_created_at: typing.Optional[dt.datetime] = OMIT,
+        ground_truth: typing.Optional[bool] = OMIT,
+        import_id: typing.Optional[int] = OMIT,
+        last_action: typing.Optional[AnnotationBulkSerializerWithSelectedItemsRequestLastAction] = OMIT,
+        last_created_by: typing.Optional[int] = OMIT,
+        lead_time: typing.Optional[float] = OMIT,
+        parent_annotation: typing.Optional[int] = OMIT,
+        parent_prediction: typing.Optional[int] = OMIT,
+        project: typing.Optional[int] = OMIT,
+        result: typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]] = OMIT,
+        selected_items: typing.Optional[SelectedItemsRequest] = OMIT,
+        task: typing.Optional[int] = OMIT,
+        tasks: typing.Optional[typing.Sequence[int]] = OMIT,
+        unique_id: typing.Optional[str] = OMIT,
+        updated_by: typing.Optional[int] = OMIT,
+        was_cancelled: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[AnnotationsCreateBulkResponseItem]:
+        """
+        Create multiple annotations at once
+
+        Parameters
+        ----------
+        bulk_created : typing.Optional[bool]
+            Annotation was created in bulk mode
+
+        completed_by : typing.Optional[int]
+
+        draft_created_at : typing.Optional[dt.datetime]
+            Draft creation time
+
+        ground_truth : typing.Optional[bool]
+            This annotation is a Ground Truth (ground_truth)
+
+        import_id : typing.Optional[int]
+            Original annotation ID that was at the import step or NULL if this annotation wasn't imported
+
+        last_action : typing.Optional[AnnotationBulkSerializerWithSelectedItemsRequestLastAction]
+            Action which was performed in the last annotation history item
+
+            * `prediction` - Created from prediction
+            * `propagated_annotation` - Created from another annotation
+            * `imported` - Imported
+            * `submitted` - Submitted
+            * `updated` - Updated
+            * `skipped` - Skipped
+            * `accepted` - Accepted
+            * `rejected` - Rejected
+            * `fixed_and_accepted` - Fixed and accepted
+            * `deleted_review` - Deleted review
+
+        last_created_by : typing.Optional[int]
+            User who created the last annotation history item
+
+        lead_time : typing.Optional[float]
+            How much time it took to annotate the task
+
+        parent_annotation : typing.Optional[int]
+            Points to the parent annotation from which this annotation was created
+
+        parent_prediction : typing.Optional[int]
+            Points to the prediction from which this annotation was created
+
+        project : typing.Optional[int]
+            Project ID for this annotation
+
+        result : typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]]
+            List of annotation results for the task
+
+        selected_items : typing.Optional[SelectedItemsRequest]
+
+        task : typing.Optional[int]
+            Corresponding task for this annotation
+
+        tasks : typing.Optional[typing.Sequence[int]]
+
+        unique_id : typing.Optional[str]
+
+        updated_by : typing.Optional[int]
+            Last user who updated this annotation
+
+        was_cancelled : typing.Optional[bool]
+            User skipped the task
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[AnnotationsCreateBulkResponseItem]
+            Bulk annotations created successfully
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.annotations.create_bulk()
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/annotations/bulk/",
+            method="POST",
+            json={
+                "bulk_created": bulk_created,
+                "completed_by": completed_by,
+                "draft_created_at": draft_created_at,
+                "ground_truth": ground_truth,
+                "import_id": import_id,
+                "last_action": convert_and_respect_annotation_metadata(
+                    object_=last_action,
+                    annotation=AnnotationBulkSerializerWithSelectedItemsRequestLastAction,
+                    direction="write",
+                ),
+                "last_created_by": last_created_by,
+                "lead_time": lead_time,
+                "parent_annotation": parent_annotation,
+                "parent_prediction": parent_prediction,
+                "project": project,
+                "result": result,
+                "selected_items": convert_and_respect_annotation_metadata(
+                    object_=selected_items, annotation=SelectedItemsRequest, direction="write"
+                ),
+                "task": task,
+                "tasks": tasks,
+                "unique_id": unique_id,
+                "updated_by": updated_by,
+                "was_cancelled": was_cancelled,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[AnnotationsCreateBulkResponseItem],
+                    construct_type(
+                        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)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
     def get(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> Annotation:
         """
         Retrieve a specific annotation for a task using the annotation result ID.
@@ -114,14 +269,14 @@ class AnnotationsClient:
         self,
         id: int,
         *,
+        completed_by: typing.Optional[int] = OMIT,
+        ground_truth: typing.Optional[bool] = OMIT,
+        lead_time: typing.Optional[float] = OMIT,
+        project: typing.Optional[int] = 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,
         updated_by: typing.Optional[int] = OMIT,
         was_cancelled: typing.Optional[bool] = OMIT,
-        ground_truth: typing.Optional[bool] = OMIT,
-        lead_time: typing.Optional[float] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Annotation:
         """
@@ -131,17 +286,23 @@ class AnnotationsClient:
         ----------
         id : int
 
-        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)
+        completed_by : typing.Optional[int]
+            User ID of the person who created this annotation
 
-        task : typing.Optional[int]
-            Corresponding task for this annotation
+        ground_truth : typing.Optional[bool]
+            This annotation is a Ground Truth
+
+        lead_time : typing.Optional[float]
+            How much time it took to annotate the task (in seconds)
 
         project : typing.Optional[int]
             Project ID for this annotation
 
-        completed_by : typing.Optional[int]
-            User ID of the person who created this annotation
+        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]
+            Corresponding task for this annotation
 
         updated_by : typing.Optional[int]
             Last user who updated this annotation
@@ -149,12 +310,6 @@ class AnnotationsClient:
         was_cancelled : typing.Optional[bool]
             User skipped the task
 
-        ground_truth : typing.Optional[bool]
-            This annotation is a Ground Truth
-
-        lead_time : typing.Optional[float]
-            How much time it took to annotate the task (in seconds)
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -172,195 +327,40 @@ class AnnotationsClient:
         )
         client.annotations.update(
             id=1,
+            ground_truth=True,
             result=[
                 {
-                    "original_width": 1920,
-                    "original_height": 1080,
-                    "image_rotation": 0,
                     "from_name": "bboxes",
+                    "image_rotation": 0,
+                    "original_height": 1080,
+                    "original_width": 1920,
                     "to_name": "image",
                     "type": "rectanglelabels",
                     "value": {
-                        "x": 20,
-                        "y": 30,
-                        "width": 50,
                         "height": 60,
                         "rotation": 0,
                         "values": {"rectanglelabels": ["Person"]},
+                        "width": 50,
+                        "x": 20,
+                        "y": 30,
                     },
                 }
             ],
             was_cancelled=False,
-            ground_truth=True,
         )
         """
         _response = self._client_wrapper.httpx_client.request(
             f"api/annotations/{jsonable_encoder(id)}/",
             method="PATCH",
             json={
-                "result": result,
-                "task": task,
-                "project": project,
                 "completed_by": completed_by,
-                "updated_by": updated_by,
-                "was_cancelled": was_cancelled,
                 "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 typing.cast(
-                    Annotation,
-                    construct_type(
-                        type_=Annotation,  # 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)
-
-    def create_bulk(
-        self,
-        *,
-        result: typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]] = OMIT,
-        completed_by: typing.Optional[int] = OMIT,
-        unique_id: typing.Optional[str] = OMIT,
-        tasks: typing.Optional[typing.Sequence[int]] = OMIT,
-        selected_items: typing.Optional[SelectedItemsRequest] = OMIT,
-        was_cancelled: typing.Optional[bool] = OMIT,
-        ground_truth: typing.Optional[bool] = OMIT,
-        draft_created_at: typing.Optional[dt.datetime] = OMIT,
-        lead_time: typing.Optional[float] = OMIT,
-        import_id: typing.Optional[int] = OMIT,
-        last_action: typing.Optional[AnnotationBulkSerializerWithSelectedItemsRequestLastAction] = OMIT,
-        bulk_created: typing.Optional[bool] = OMIT,
-        task: typing.Optional[int] = OMIT,
-        project: typing.Optional[int] = OMIT,
-        updated_by: typing.Optional[int] = OMIT,
-        parent_prediction: typing.Optional[int] = OMIT,
-        parent_annotation: typing.Optional[int] = OMIT,
-        last_created_by: typing.Optional[int] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.List[AnnotationsCreateBulkResponseItem]:
-        """
-        Create multiple annotations at once
-
-        Parameters
-        ----------
-        result : typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]]
-            List of annotation results for the task
-
-        completed_by : typing.Optional[int]
-
-        unique_id : typing.Optional[str]
-
-        tasks : typing.Optional[typing.Sequence[int]]
-
-        selected_items : typing.Optional[SelectedItemsRequest]
-
-        was_cancelled : typing.Optional[bool]
-            User skipped the task
-
-        ground_truth : typing.Optional[bool]
-            This annotation is a Ground Truth (ground_truth)
-
-        draft_created_at : typing.Optional[dt.datetime]
-            Draft creation time
-
-        lead_time : typing.Optional[float]
-            How much time it took to annotate the task
-
-        import_id : typing.Optional[int]
-            Original annotation ID that was at the import step or NULL if this annotation wasn't imported
-
-        last_action : typing.Optional[AnnotationBulkSerializerWithSelectedItemsRequestLastAction]
-            Action which was performed in the last annotation history item
-
-            * `prediction` - Created from prediction
-            * `propagated_annotation` - Created from another annotation
-            * `imported` - Imported
-            * `submitted` - Submitted
-            * `updated` - Updated
-            * `skipped` - Skipped
-            * `accepted` - Accepted
-            * `rejected` - Rejected
-            * `fixed_and_accepted` - Fixed and accepted
-            * `deleted_review` - Deleted review
-
-        bulk_created : typing.Optional[bool]
-            Annotation was created in bulk mode
-
-        task : typing.Optional[int]
-            Corresponding task for this annotation
-
-        project : typing.Optional[int]
-            Project ID for this annotation
-
-        updated_by : typing.Optional[int]
-            Last user who updated this annotation
-
-        parent_prediction : typing.Optional[int]
-            Points to the prediction from which this annotation was created
-
-        parent_annotation : typing.Optional[int]
-            Points to the parent annotation from which this annotation was created
-
-        last_created_by : typing.Optional[int]
-            User who created the last annotation history item
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        typing.List[AnnotationsCreateBulkResponseItem]
-            Bulk annotations created successfully
-
-        Examples
-        --------
-        from label_studio_sdk import LabelStudio
-
-        client = LabelStudio(
-            api_key="YOUR_API_KEY",
-        )
-        client.annotations.create_bulk()
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            "api/annotations/bulk/",
-            method="POST",
-            json={
-                "result": result,
-                "completed_by": completed_by,
-                "unique_id": unique_id,
-                "tasks": tasks,
-                "selected_items": convert_and_respect_annotation_metadata(
-                    object_=selected_items, annotation=SelectedItemsRequest, direction="write"
-                ),
-                "was_cancelled": was_cancelled,
-                "ground_truth": ground_truth,
-                "draft_created_at": draft_created_at,
-                "lead_time": lead_time,
-                "import_id": import_id,
-                "last_action": convert_and_respect_annotation_metadata(
-                    object_=last_action,
-                    annotation=AnnotationBulkSerializerWithSelectedItemsRequestLastAction,
-                    direction="write",
-                ),
-                "bulk_created": bulk_created,
-                "task": task,
                 "project": project,
+                "result": result,
+                "task": task,
                 "updated_by": updated_by,
-                "parent_prediction": parent_prediction,
-                "parent_annotation": parent_annotation,
-                "last_created_by": last_created_by,
+                "was_cancelled": was_cancelled,
             },
             headers={
                 "content-type": "application/json",
@@ -371,9 +371,9 @@ class AnnotationsClient:
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    typing.List[AnnotationsCreateBulkResponseItem],
+                    Annotation,
                     construct_type(
-                        type_=typing.List[AnnotationsCreateBulkResponseItem],  # type: ignore
+                        type_=Annotation,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -441,14 +441,14 @@ class AnnotationsClient:
         self,
         id: int,
         *,
+        completed_by: typing.Optional[int] = OMIT,
+        ground_truth: typing.Optional[bool] = OMIT,
+        lead_time: typing.Optional[float] = OMIT,
+        project: typing.Optional[int] = 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,
         updated_by: typing.Optional[int] = OMIT,
         was_cancelled: typing.Optional[bool] = OMIT,
-        ground_truth: typing.Optional[bool] = OMIT,
-        lead_time: typing.Optional[float] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Annotation:
         """
@@ -474,17 +474,23 @@ class AnnotationsClient:
         id : int
             Task ID
 
-        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)
+        completed_by : typing.Optional[int]
+            User ID of the person who created this annotation
 
-        task : typing.Optional[int]
-            Corresponding task for this annotation
+        ground_truth : typing.Optional[bool]
+            This annotation is a Ground Truth
+
+        lead_time : typing.Optional[float]
+            How much time it took to annotate the task (in seconds)
 
         project : typing.Optional[int]
             Project ID for this annotation
 
-        completed_by : typing.Optional[int]
-            User ID of the person who created this annotation
+        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]
+            Corresponding task for this annotation
 
         updated_by : typing.Optional[int]
             Last user who updated this annotation
@@ -492,12 +498,6 @@ class AnnotationsClient:
         was_cancelled : typing.Optional[bool]
             User skipped the task
 
-        ground_truth : typing.Optional[bool]
-            This annotation is a Ground Truth
-
-        lead_time : typing.Optional[float]
-            How much time it took to annotate the task (in seconds)
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -515,40 +515,40 @@ class AnnotationsClient:
         )
         client.annotations.create(
             id=1,
+            ground_truth=True,
             result=[
                 {
-                    "original_width": 1920,
-                    "original_height": 1080,
-                    "image_rotation": 0,
                     "from_name": "bboxes",
+                    "image_rotation": 0,
+                    "original_height": 1080,
+                    "original_width": 1920,
                     "to_name": "image",
                     "type": "rectanglelabels",
                     "value": {
-                        "x": 20,
-                        "y": 30,
-                        "width": 50,
                         "height": 60,
                         "rotation": 0,
                         "values": {"rectanglelabels": ["Person"]},
+                        "width": 50,
+                        "x": 20,
+                        "y": 30,
                     },
                 }
             ],
             was_cancelled=False,
-            ground_truth=True,
         )
         """
         _response = self._client_wrapper.httpx_client.request(
             f"api/tasks/{jsonable_encoder(id)}/annotations/",
             method="POST",
             json={
+                "completed_by": completed_by,
+                "ground_truth": ground_truth,
+                "lead_time": lead_time,
+                "project": project,
                 "result": result,
                 "task": task,
-                "project": project,
-                "completed_by": completed_by,
                 "updated_by": updated_by,
                 "was_cancelled": was_cancelled,
-                "ground_truth": ground_truth,
-                "lead_time": lead_time,
             },
             headers={
                 "content-type": "application/json",
@@ -575,21 +575,102 @@ class AsyncAnnotationsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
         self._client_wrapper = client_wrapper
 
-    async def get(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> Annotation:
+    async def create_bulk(
+        self,
+        *,
+        bulk_created: typing.Optional[bool] = OMIT,
+        completed_by: typing.Optional[int] = OMIT,
+        draft_created_at: typing.Optional[dt.datetime] = OMIT,
+        ground_truth: typing.Optional[bool] = OMIT,
+        import_id: typing.Optional[int] = OMIT,
+        last_action: typing.Optional[AnnotationBulkSerializerWithSelectedItemsRequestLastAction] = OMIT,
+        last_created_by: typing.Optional[int] = OMIT,
+        lead_time: typing.Optional[float] = OMIT,
+        parent_annotation: typing.Optional[int] = OMIT,
+        parent_prediction: typing.Optional[int] = OMIT,
+        project: typing.Optional[int] = OMIT,
+        result: typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]] = OMIT,
+        selected_items: typing.Optional[SelectedItemsRequest] = OMIT,
+        task: typing.Optional[int] = OMIT,
+        tasks: typing.Optional[typing.Sequence[int]] = OMIT,
+        unique_id: typing.Optional[str] = OMIT,
+        updated_by: typing.Optional[int] = OMIT,
+        was_cancelled: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[AnnotationsCreateBulkResponseItem]:
         """
-        Retrieve a specific annotation for a task using the annotation result ID.
+        Create multiple annotations at once
 
         Parameters
         ----------
-        id : int
+        bulk_created : typing.Optional[bool]
+            Annotation was created in bulk mode
+
+        completed_by : typing.Optional[int]
+
+        draft_created_at : typing.Optional[dt.datetime]
+            Draft creation time
+
+        ground_truth : typing.Optional[bool]
+            This annotation is a Ground Truth (ground_truth)
+
+        import_id : typing.Optional[int]
+            Original annotation ID that was at the import step or NULL if this annotation wasn't imported
+
+        last_action : typing.Optional[AnnotationBulkSerializerWithSelectedItemsRequestLastAction]
+            Action which was performed in the last annotation history item
+
+            * `prediction` - Created from prediction
+            * `propagated_annotation` - Created from another annotation
+            * `imported` - Imported
+            * `submitted` - Submitted
+            * `updated` - Updated
+            * `skipped` - Skipped
+            * `accepted` - Accepted
+            * `rejected` - Rejected
+            * `fixed_and_accepted` - Fixed and accepted
+            * `deleted_review` - Deleted review
+
+        last_created_by : typing.Optional[int]
+            User who created the last annotation history item
+
+        lead_time : typing.Optional[float]
+            How much time it took to annotate the task
+
+        parent_annotation : typing.Optional[int]
+            Points to the parent annotation from which this annotation was created
+
+        parent_prediction : typing.Optional[int]
+            Points to the prediction from which this annotation was created
+
+        project : typing.Optional[int]
+            Project ID for this annotation
+
+        result : typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]]
+            List of annotation results for the task
+
+        selected_items : typing.Optional[SelectedItemsRequest]
+
+        task : typing.Optional[int]
+            Corresponding task for this annotation
+
+        tasks : typing.Optional[typing.Sequence[int]]
+
+        unique_id : typing.Optional[str]
+
+        updated_by : typing.Optional[int]
+            Last user who updated this annotation
+
+        was_cancelled : typing.Optional[bool]
+            User skipped the task
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        Annotation
-            Retrieved annotation
+        typing.List[AnnotationsCreateBulkResponseItem]
+            Bulk annotations created successfully
 
         Examples
         --------
@@ -603,24 +684,52 @@ class AsyncAnnotationsClient:
 
 
         async def main() -> None:
-            await client.annotations.get(
-                id=1,
-            )
+            await client.annotations.create_bulk()
 
 
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            f"api/annotations/{jsonable_encoder(id)}/",
-            method="GET",
+            "api/annotations/bulk/",
+            method="POST",
+            json={
+                "bulk_created": bulk_created,
+                "completed_by": completed_by,
+                "draft_created_at": draft_created_at,
+                "ground_truth": ground_truth,
+                "import_id": import_id,
+                "last_action": convert_and_respect_annotation_metadata(
+                    object_=last_action,
+                    annotation=AnnotationBulkSerializerWithSelectedItemsRequestLastAction,
+                    direction="write",
+                ),
+                "last_created_by": last_created_by,
+                "lead_time": lead_time,
+                "parent_annotation": parent_annotation,
+                "parent_prediction": parent_prediction,
+                "project": project,
+                "result": result,
+                "selected_items": convert_and_respect_annotation_metadata(
+                    object_=selected_items, annotation=SelectedItemsRequest, direction="write"
+                ),
+                "task": task,
+                "tasks": tasks,
+                "unique_id": unique_id,
+                "updated_by": updated_by,
+                "was_cancelled": was_cancelled,
+            },
+            headers={
+                "content-type": "application/json",
+            },
             request_options=request_options,
+            omit=OMIT,
         )
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    Annotation,
+                    typing.List[AnnotationsCreateBulkResponseItem],
                     construct_type(
-                        type_=Annotation,  # type: ignore
+                        type_=typing.List[AnnotationsCreateBulkResponseItem],  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -629,9 +738,9 @@ class AsyncAnnotationsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def delete(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+    async def get(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> Annotation:
         """
-        Delete an annotation. This action can't be undone!
+        Retrieve a specific annotation for a task using the annotation result ID.
 
         Parameters
         ----------
@@ -642,7 +751,8 @@ class AsyncAnnotationsClient:
 
         Returns
         -------
-        None
+        Annotation
+            Retrieved annotation
 
         Examples
         --------
@@ -656,7 +766,7 @@ class AsyncAnnotationsClient:
 
 
         async def main() -> None:
-            await client.annotations.delete(
+            await client.annotations.get(
                 id=1,
             )
 
@@ -665,69 +775,37 @@ class AsyncAnnotationsClient:
         """
         _response = await self._client_wrapper.httpx_client.request(
             f"api/annotations/{jsonable_encoder(id)}/",
-            method="DELETE",
+            method="GET",
             request_options=request_options,
         )
         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)
-
-    async def update(
-        self,
-        id: int,
-        *,
-        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,
-        updated_by: typing.Optional[int] = OMIT,
-        was_cancelled: typing.Optional[bool] = OMIT,
-        ground_truth: typing.Optional[bool] = OMIT,
-        lead_time: typing.Optional[float] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> Annotation:
-        """
-        Update existing attributes on an annotation.
-
-        Parameters
-        ----------
-        id : int
-
-        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]
-            Corresponding task for this annotation
-
-        project : typing.Optional[int]
-            Project ID for this annotation
-
-        completed_by : typing.Optional[int]
-            User ID of the person who created this annotation
-
-        updated_by : typing.Optional[int]
-            Last user who updated this annotation
-
-        was_cancelled : typing.Optional[bool]
-            User skipped the task
+                return typing.cast(
+                    Annotation,
+                    construct_type(
+                        type_=Annotation,  # 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)
 
-        ground_truth : typing.Optional[bool]
-            This annotation is a Ground Truth
+    async def delete(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+        """
+        Delete an annotation. This action can't be undone!
 
-        lead_time : typing.Optional[float]
-            How much time it took to annotate the task (in seconds)
+        Parameters
+        ----------
+        id : int
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        Annotation
-            Updated annotation
+        None
 
         Examples
         --------
@@ -741,28 +819,8 @@ class AsyncAnnotationsClient:
 
 
         async def main() -> None:
-            await client.annotations.update(
+            await client.annotations.delete(
                 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,
             )
 
 
@@ -770,133 +828,69 @@ class AsyncAnnotationsClient:
         """
         _response = await self._client_wrapper.httpx_client.request(
             f"api/annotations/{jsonable_encoder(id)}/",
-            method="PATCH",
-            json={
-                "result": result,
-                "task": task,
-                "project": project,
-                "completed_by": completed_by,
-                "updated_by": updated_by,
-                "was_cancelled": was_cancelled,
-                "ground_truth": ground_truth,
-                "lead_time": lead_time,
-            },
-            headers={
-                "content-type": "application/json",
-            },
+            method="DELETE",
             request_options=request_options,
-            omit=OMIT,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    Annotation,
-                    construct_type(
-                        type_=Annotation,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
+                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)
 
-    async def create_bulk(
+    async def update(
         self,
+        id: int,
         *,
-        result: typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]] = OMIT,
         completed_by: typing.Optional[int] = OMIT,
-        unique_id: typing.Optional[str] = OMIT,
-        tasks: typing.Optional[typing.Sequence[int]] = OMIT,
-        selected_items: typing.Optional[SelectedItemsRequest] = OMIT,
-        was_cancelled: typing.Optional[bool] = OMIT,
         ground_truth: typing.Optional[bool] = OMIT,
-        draft_created_at: typing.Optional[dt.datetime] = OMIT,
         lead_time: typing.Optional[float] = OMIT,
-        import_id: typing.Optional[int] = OMIT,
-        last_action: typing.Optional[AnnotationBulkSerializerWithSelectedItemsRequestLastAction] = OMIT,
-        bulk_created: typing.Optional[bool] = OMIT,
-        task: typing.Optional[int] = OMIT,
         project: typing.Optional[int] = OMIT,
+        result: typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]] = OMIT,
+        task: typing.Optional[int] = OMIT,
         updated_by: typing.Optional[int] = OMIT,
-        parent_prediction: typing.Optional[int] = OMIT,
-        parent_annotation: typing.Optional[int] = OMIT,
-        last_created_by: typing.Optional[int] = OMIT,
+        was_cancelled: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.List[AnnotationsCreateBulkResponseItem]:
+    ) -> Annotation:
         """
-        Create multiple annotations at once
+        Update existing attributes on an annotation.
 
         Parameters
         ----------
-        result : typing.Optional[typing.Sequence[typing.Dict[str, typing.Optional[typing.Any]]]]
-            List of annotation results for the task
+        id : int
 
         completed_by : typing.Optional[int]
-
-        unique_id : typing.Optional[str]
-
-        tasks : typing.Optional[typing.Sequence[int]]
-
-        selected_items : typing.Optional[SelectedItemsRequest]
-
-        was_cancelled : typing.Optional[bool]
-            User skipped the task
+            User ID of the person who created this annotation
 
         ground_truth : typing.Optional[bool]
-            This annotation is a Ground Truth (ground_truth)
-
-        draft_created_at : typing.Optional[dt.datetime]
-            Draft creation time
+            This annotation is a Ground Truth
 
         lead_time : typing.Optional[float]
-            How much time it took to annotate the task
-
-        import_id : typing.Optional[int]
-            Original annotation ID that was at the import step or NULL if this annotation wasn't imported
-
-        last_action : typing.Optional[AnnotationBulkSerializerWithSelectedItemsRequestLastAction]
-            Action which was performed in the last annotation history item
+            How much time it took to annotate the task (in seconds)
 
-            * `prediction` - Created from prediction
-            * `propagated_annotation` - Created from another annotation
-            * `imported` - Imported
-            * `submitted` - Submitted
-            * `updated` - Updated
-            * `skipped` - Skipped
-            * `accepted` - Accepted
-            * `rejected` - Rejected
-            * `fixed_and_accepted` - Fixed and accepted
-            * `deleted_review` - Deleted review
+        project : typing.Optional[int]
+            Project ID for this annotation
 
-        bulk_created : typing.Optional[bool]
-            Annotation was created in bulk mode
+        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]
             Corresponding task for this annotation
 
-        project : typing.Optional[int]
-            Project ID for this annotation
-
         updated_by : typing.Optional[int]
             Last user who updated this annotation
 
-        parent_prediction : typing.Optional[int]
-            Points to the prediction from which this annotation was created
-
-        parent_annotation : typing.Optional[int]
-            Points to the parent annotation from which this annotation was created
-
-        last_created_by : typing.Optional[int]
-            User who created the last annotation history item
+        was_cancelled : typing.Optional[bool]
+            User skipped the task
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        typing.List[AnnotationsCreateBulkResponseItem]
-            Bulk annotations created successfully
+        Annotation
+            Updated annotation
 
         Examples
         --------
@@ -910,39 +904,45 @@ class AsyncAnnotationsClient:
 
 
         async def main() -> None:
-            await client.annotations.create_bulk()
+            await client.annotations.update(
+                id=1,
+                ground_truth=True,
+                result=[
+                    {
+                        "from_name": "bboxes",
+                        "image_rotation": 0,
+                        "original_height": 1080,
+                        "original_width": 1920,
+                        "to_name": "image",
+                        "type": "rectanglelabels",
+                        "value": {
+                            "height": 60,
+                            "rotation": 0,
+                            "values": {"rectanglelabels": ["Person"]},
+                            "width": 50,
+                            "x": 20,
+                            "y": 30,
+                        },
+                    }
+                ],
+                was_cancelled=False,
+            )
 
 
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            "api/annotations/bulk/",
-            method="POST",
+            f"api/annotations/{jsonable_encoder(id)}/",
+            method="PATCH",
             json={
-                "result": result,
                 "completed_by": completed_by,
-                "unique_id": unique_id,
-                "tasks": tasks,
-                "selected_items": convert_and_respect_annotation_metadata(
-                    object_=selected_items, annotation=SelectedItemsRequest, direction="write"
-                ),
-                "was_cancelled": was_cancelled,
                 "ground_truth": ground_truth,
-                "draft_created_at": draft_created_at,
                 "lead_time": lead_time,
-                "import_id": import_id,
-                "last_action": convert_and_respect_annotation_metadata(
-                    object_=last_action,
-                    annotation=AnnotationBulkSerializerWithSelectedItemsRequestLastAction,
-                    direction="write",
-                ),
-                "bulk_created": bulk_created,
-                "task": task,
                 "project": project,
+                "result": result,
+                "task": task,
                 "updated_by": updated_by,
-                "parent_prediction": parent_prediction,
-                "parent_annotation": parent_annotation,
-                "last_created_by": last_created_by,
+                "was_cancelled": was_cancelled,
             },
             headers={
                 "content-type": "application/json",
@@ -953,9 +953,9 @@ class AsyncAnnotationsClient:
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    typing.List[AnnotationsCreateBulkResponseItem],
+                    Annotation,
                     construct_type(
-                        type_=typing.List[AnnotationsCreateBulkResponseItem],  # type: ignore
+                        type_=Annotation,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -1031,14 +1031,14 @@ class AsyncAnnotationsClient:
         self,
         id: int,
         *,
+        completed_by: typing.Optional[int] = OMIT,
+        ground_truth: typing.Optional[bool] = OMIT,
+        lead_time: typing.Optional[float] = OMIT,
+        project: typing.Optional[int] = 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,
         updated_by: typing.Optional[int] = OMIT,
         was_cancelled: typing.Optional[bool] = OMIT,
-        ground_truth: typing.Optional[bool] = OMIT,
-        lead_time: typing.Optional[float] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Annotation:
         """
@@ -1064,17 +1064,23 @@ class AsyncAnnotationsClient:
         id : int
             Task ID
 
-        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)
+        completed_by : typing.Optional[int]
+            User ID of the person who created this annotation
 
-        task : typing.Optional[int]
-            Corresponding task for this annotation
+        ground_truth : typing.Optional[bool]
+            This annotation is a Ground Truth
+
+        lead_time : typing.Optional[float]
+            How much time it took to annotate the task (in seconds)
 
         project : typing.Optional[int]
             Project ID for this annotation
 
-        completed_by : typing.Optional[int]
-            User ID of the person who created this annotation
+        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]
+            Corresponding task for this annotation
 
         updated_by : typing.Optional[int]
             Last user who updated this annotation
@@ -1082,12 +1088,6 @@ class AsyncAnnotationsClient:
         was_cancelled : typing.Optional[bool]
             User skipped the task
 
-        ground_truth : typing.Optional[bool]
-            This annotation is a Ground Truth
-
-        lead_time : typing.Optional[float]
-            How much time it took to annotate the task (in seconds)
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1110,26 +1110,26 @@ class AsyncAnnotationsClient:
         async def main() -> None:
             await client.annotations.create(
                 id=1,
+                ground_truth=True,
                 result=[
                     {
-                        "original_width": 1920,
-                        "original_height": 1080,
-                        "image_rotation": 0,
                         "from_name": "bboxes",
+                        "image_rotation": 0,
+                        "original_height": 1080,
+                        "original_width": 1920,
                         "to_name": "image",
                         "type": "rectanglelabels",
                         "value": {
-                            "x": 20,
-                            "y": 30,
-                            "width": 50,
                             "height": 60,
                             "rotation": 0,
                             "values": {"rectanglelabels": ["Person"]},
+                            "width": 50,
+                            "x": 20,
+                            "y": 30,
                         },
                     }
                 ],
                 was_cancelled=False,
-                ground_truth=True,
             )
 
 
@@ -1139,14 +1139,14 @@ class AsyncAnnotationsClient:
             f"api/tasks/{jsonable_encoder(id)}/annotations/",
             method="POST",
             json={
+                "completed_by": completed_by,
+                "ground_truth": ground_truth,
+                "lead_time": lead_time,
+                "project": project,
                 "result": result,
                 "task": task,
-                "project": project,
-                "completed_by": completed_by,
                 "updated_by": updated_by,
                 "was_cancelled": was_cancelled,
-                "ground_truth": ground_truth,
-                "lead_time": lead_time,
             },
             headers={
                 "content-type": "application/json",