benchling-sdk 1.18.1__py3-none-any.whl → 1.20__py3-none-any.whl

benchling_sdk/services/v2/stable/container_service.py

@@ -34,8 +34,10 @@ from benchling_sdk.helpers.serialization_helpers import (
     optional_array_query_param,
     schema_fields_query_param,
 )
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
+    BulkCreateContainersAsyncTaskResponse,
+    BulkUpdateContainersAsyncTaskResponse,
     Container,
     ContainerBulkUpdateItem,
     ContainerContent,
@@ -59,6 +61,7 @@ from benchling_sdk.models import (
     MultipleContainersTransfersList,
     PrintLabels,
     SampleRestrictionStatus,
+    TransfersAsyncTaskResponse,
 )
 from benchling_sdk.services.v2.base_service import BaseService
 
@@ -264,7 +267,9 @@ class ContainerService(BaseService):
         return containers_list.containers
 
     @api_method
-    def bulk_create(self, containers: Iterable[ContainerCreate]) -> AsyncTaskLink:
+    def bulk_create(
+        self, containers: Iterable[ContainerCreate]
+    ) -> TaskHelper[BulkCreateContainersAsyncTaskResponse]:
         """
         Bulk create containers.
 
@@ -272,10 +277,12 @@ class ContainerService(BaseService):
         """
         body = ContainersBulkCreateRequest(list(containers))
         response = bulk_create_containers.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkCreateContainersAsyncTaskResponse)
 
     @api_method
-    def bulk_update(self, containers: Iterable[ContainerBulkUpdateItem]) -> AsyncTaskLink:
+    def bulk_update(
+        self, containers: Iterable[ContainerBulkUpdateItem]
+    ) -> TaskHelper[BulkUpdateContainersAsyncTaskResponse]:
         """
         Bulk update containers.
 
@@ -283,7 +290,7 @@ class ContainerService(BaseService):
         """
         body = ContainersBulkUpdateRequest(list(containers))
         response = bulk_update_containers.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateContainersAsyncTaskResponse)
 
     @api_method
     def create(self, container: ContainerCreate) -> Container:
@@ -440,7 +447,7 @@ class ContainerService(BaseService):
     @api_method
     def transfer_into_containers(
         self, transfer_requests: Iterable[MultipleContainersTransfer]
-    ) -> AsyncTaskLink:
+    ) -> TaskHelper[TransfersAsyncTaskResponse]:
         """
         Transfer into containers.
 
@@ -448,4 +455,4 @@ class ContainerService(BaseService):
         """
         multiple_requests = MultipleContainersTransfersList(transfers=list(transfer_requests))
         response = transfer_into_containers.sync_detailed(client=self.client, json_body=multiple_requests)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, TransfersAsyncTaskResponse)

benchling_sdk/services/v2/stable/custom_entity_service.py

@@ -26,8 +26,10 @@ from benchling_sdk.helpers.serialization_helpers import (
     optional_array_query_param,
     schema_fields_query_param,
 )
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
+    BulkCreateCustomEntitiesAsyncTaskResponse,
+    BulkUpdateCustomEntitiesAsyncTaskResponse,
     CustomEntitiesArchivalChange,
     CustomEntitiesArchive,
     CustomEntitiesBulkCreateRequest,
@@ -250,7 +252,9 @@ class CustomEntityService(BaseService):
         return custom_entities.custom_entities
 
     @api_method
-    def bulk_create(self, entities: Iterable[CustomEntityBulkCreate]) -> AsyncTaskLink:
+    def bulk_create(
+        self, entities: Iterable[CustomEntityBulkCreate]
+    ) -> TaskHelper[BulkCreateCustomEntitiesAsyncTaskResponse]:
         """
         Bulk create custom entities.
 
@@ -258,10 +262,12 @@ class CustomEntityService(BaseService):
         """
         body = CustomEntitiesBulkCreateRequest(list(entities))
         response = bulk_create_custom_entities.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkCreateCustomEntitiesAsyncTaskResponse)
 
     @api_method
-    def bulk_update(self, entities: Iterable[CustomEntityBulkUpdate]) -> AsyncTaskLink:
+    def bulk_update(
+        self, entities: Iterable[CustomEntityBulkUpdate]
+    ) -> TaskHelper[BulkUpdateCustomEntitiesAsyncTaskResponse]:
         """
         Bulk update custom entities.
 
@@ -269,7 +275,7 @@ class CustomEntityService(BaseService):
         """
         body = CustomEntitiesBulkUpdateRequest(list(entities))
         response = bulk_update_custom_entities.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateCustomEntitiesAsyncTaskResponse)
 
     @api_method
     def upsert(self, entity_registry_id: str, entity: CustomEntityUpsertRequest) -> CustomEntity:
@@ -284,11 +290,13 @@ class CustomEntityService(BaseService):
         return model_from_detailed(response)
 
     @api_method
-    def bulk_upsert(self, body: CustomEntitiesBulkUpsertRequest) -> AsyncTaskLink:
+    def bulk_upsert(
+        self, body: CustomEntitiesBulkUpsertRequest
+    ) -> TaskHelper[BulkUpdateCustomEntitiesAsyncTaskResponse]:
         """
         Bulk update custom entities.
 
         See https://benchling.com/api/reference#/Custom%20Entities/bulkUpsertCustomEntities
         """
         response = bulk_upsert_custom_entities.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateCustomEntitiesAsyncTaskResponse)

benchling_sdk/services/v2/stable/dna_alignments_service.py

@@ -16,8 +16,8 @@ from benchling_sdk.helpers.logging_helpers import log_deprecation
 from benchling_sdk.helpers.pagination_helpers import NextToken, PageIterator
 from benchling_sdk.helpers.response_helpers import model_from_detailed
 from benchling_sdk.helpers.serialization_helpers import none_as_unset, optional_array_query_param
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
     DnaAlignment,
     DnaAlignmentsPaginatedList,
     DnaAlignmentSummary,
@@ -126,7 +126,9 @@ class DnaAlignmentsService(BaseService):
         return PageIterator(api_call, results_extractor)
 
     @api_method
-    def create_template_alignment(self, template_alignment: DnaTemplateAlignmentCreate) -> AsyncTaskLink:
+    def create_template_alignment(
+        self, template_alignment: DnaTemplateAlignmentCreate
+    ) -> TaskHelper[DnaAlignment]:
         """
         Create a template DNA alignment (Deprecated).
 
@@ -141,10 +143,12 @@ class DnaAlignmentsService(BaseService):
         response = create_dna_template_alignment.sync_detailed(
             client=self.client, json_body=template_alignment
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, DnaAlignment)
 
     @api_method
-    def create_consensus_alignment(self, consensus_alignment: DnaConsensusAlignmentCreate) -> AsyncTaskLink:
+    def create_consensus_alignment(
+        self, consensus_alignment: DnaConsensusAlignmentCreate
+    ) -> TaskHelper[DnaAlignment]:
         """
         Create a consensus DNA alignment (Deprecated).
 
@@ -159,7 +163,7 @@ class DnaAlignmentsService(BaseService):
         response = create_dna_consensus_alignment.sync_detailed(
             client=self.client, json_body=consensus_alignment
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, DnaAlignment)
 
     @api_method
     def delete_alignment(self, dna_alignment_id: str) -> None:

benchling_sdk/services/v2/stable/dna_oligo_service.py

@@ -24,8 +24,10 @@ from benchling_sdk.helpers.serialization_helpers import (
     optional_array_query_param,
     schema_fields_query_param,
 )
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
+    BulkCreateDnaOligosAsyncTaskResponse,
+    BulkUpdateDnaOligosAsyncTaskResponse,
     DnaOligo,
     DnaOligoBulkUpdate,
     DnaOligoCreate,
@@ -227,7 +229,9 @@ class DnaOligoService(BaseService):
         return model_from_detailed(response)
 
     @api_method
-    def bulk_create(self, dna_oligos: Iterable[DnaOligoCreate]) -> AsyncTaskLink:
+    def bulk_create(
+        self, dna_oligos: Iterable[DnaOligoCreate]
+    ) -> TaskHelper[BulkCreateDnaOligosAsyncTaskResponse]:
         """
         Bulk create DNA Oligos.
 
@@ -235,10 +239,12 @@ class DnaOligoService(BaseService):
         """
         body = DnaOligosBulkCreateRequest(list(dna_oligos))
         response = bulk_create_dna_oligos.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkCreateDnaOligosAsyncTaskResponse)
 
     @api_method
-    def bulk_update(self, dna_oligos: Iterable[DnaOligoBulkUpdate]) -> AsyncTaskLink:
+    def bulk_update(
+        self, dna_oligos: Iterable[DnaOligoBulkUpdate]
+    ) -> TaskHelper[BulkUpdateDnaOligosAsyncTaskResponse]:
         """
         Bulk update DNA oligos.
 
@@ -246,7 +252,7 @@ class DnaOligoService(BaseService):
         """
         body = DnaOligosBulkUpdateRequest(list(dna_oligos))
         response = bulk_update_dna_oligos.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateDnaOligosAsyncTaskResponse)
 
     @api_method
     def upsert(self, entity_registry_id: str, dna_oligo: OligoUpsertRequest) -> DnaOligo:
@@ -263,7 +269,7 @@ class DnaOligoService(BaseService):
     @api_method
     def bulk_upsert(
         self, body: DnaOligosBulkUpsertRequest, returning: Optional[Iterable[str]] = None
-    ) -> AsyncTaskLink:
+    ) -> TaskHelper[BulkUpdateDnaOligosAsyncTaskResponse]:
         """
         Bulk create or update DNA Oligos.
 
@@ -273,4 +279,4 @@ class DnaOligoService(BaseService):
         response = bulk_upsert_dna_oligos.sync_detailed(
             client=self.client, json_body=body, returning=none_as_unset(returning_string)
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateDnaOligosAsyncTaskResponse)

benchling_sdk/services/v2/stable/dna_sequence_service.py

@@ -34,10 +34,12 @@ from benchling_sdk.helpers.serialization_helpers import (
     optional_array_query_param,
     schema_fields_query_param,
 )
+from benchling_sdk.helpers.task_helpers import EmptyTaskResponse, TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
     AutoAnnotateDnaSequences,
     AutofillSequences,
+    BulkCreateDnaSequencesAsyncTaskResponse,
+    BulkUpdateDnaSequencesAsyncTaskResponse,
     DnaSequence,
     DnaSequenceBulkCreate,
     DnaSequenceBulkUpdate,
@@ -53,6 +55,7 @@ from benchling_sdk.models import (
     DnaSequenceUpdate,
     DnaSequenceUpsertRequest,
     EntityArchiveReason,
+    FindMatchingRegionsDnaAsyncTaskResponse,
     ListDNASequencesSort,
     MatchBasesRequest,
     OptimizeCodons,
@@ -267,7 +270,9 @@ class DnaSequenceService(BaseService):
         return dna_sequences_results.dna_sequences
 
     @api_method
-    def bulk_create(self, dna_sequences: Iterable[DnaSequenceBulkCreate]) -> AsyncTaskLink:
+    def bulk_create(
+        self, dna_sequences: Iterable[DnaSequenceBulkCreate]
+    ) -> TaskHelper[BulkCreateDnaSequencesAsyncTaskResponse]:
         """
         Bulk create DNA sequences.
 
@@ -275,10 +280,12 @@ class DnaSequenceService(BaseService):
         """
         body = DnaSequencesBulkCreateRequest(list(dna_sequences))
         response = bulk_create_dna_sequences.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkCreateDnaSequencesAsyncTaskResponse)
 
     @api_method
-    def bulk_update(self, dna_sequences: Iterable[DnaSequenceBulkUpdate]) -> AsyncTaskLink:
+    def bulk_update(
+        self, dna_sequences: Iterable[DnaSequenceBulkUpdate]
+    ) -> TaskHelper[BulkUpdateDnaSequencesAsyncTaskResponse]:
         """
         Bulk update DNA sequences.
 
@@ -286,10 +293,10 @@ class DnaSequenceService(BaseService):
         """
         body = DnaSequencesBulkUpdateRequest(list(dna_sequences))
         response = bulk_update_dna_sequences.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateDnaSequencesAsyncTaskResponse)
 
     @api_method
-    def autofill_parts(self, dna_sequence_ids: Iterable[str]) -> AsyncTaskLink:
+    def autofill_parts(self, dna_sequence_ids: Iterable[str]) -> TaskHelper[EmptyTaskResponse]:
         """
         Autofill DNA sequence parts.
 
@@ -297,10 +304,10 @@ class DnaSequenceService(BaseService):
         """
         body = AutofillSequences(dna_sequence_ids=list(dna_sequence_ids))
         response = autofill_dna_sequence_parts.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)
 
     @api_method
-    def autofill_transcriptions(self, dna_sequence_ids: Iterable[str]) -> AsyncTaskLink:
+    def autofill_transcriptions(self, dna_sequence_ids: Iterable[str]) -> TaskHelper[EmptyTaskResponse]:
         """
         Autofill DNA sequence transcriptions.
 
@@ -308,10 +315,10 @@ class DnaSequenceService(BaseService):
         """
         body = AutofillSequences(dna_sequence_ids=list(dna_sequence_ids))
         response = autofill_dna_sequence_transcriptions.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)
 
     @api_method
-    def autofill_translations(self, dna_sequence_ids: Iterable[str]) -> AsyncTaskLink:
+    def autofill_translations(self, dna_sequence_ids: Iterable[str]) -> TaskHelper[EmptyTaskResponse]:
         """
         Autofill DNA sequence translations.
 
@@ -319,17 +326,17 @@ class DnaSequenceService(BaseService):
         """
         body = AutofillSequences(dna_sequence_ids=list(dna_sequence_ids))
         response = autofill_dna_sequence_translations.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)
 
     @api_method
-    def auto_annotate(self, auto_annotate: AutoAnnotateDnaSequences) -> AsyncTaskLink:
+    def auto_annotate(self, auto_annotate: AutoAnnotateDnaSequences) -> TaskHelper[EmptyTaskResponse]:
         """
         Auto-annotate DNA sequences with matching features from specified Feature Libraries.
 
         See https://benchling.com/api/reference#/DNA%20Sequences/autoAnnotateDnaSequences
         """
         response = auto_annotate_dna_sequences.sync_detailed(client=self.client, json_body=auto_annotate)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)
 
     @api_method
     def upsert(self, entity_registry_id: str, dna_sequence: DnaSequenceUpsertRequest) -> DnaSequence:
@@ -346,7 +353,7 @@ class DnaSequenceService(BaseService):
     @api_method
     def bulk_upsert(
         self, body: DnaSequencesBulkUpsertRequest, returning: Optional[Iterable[str]] = None
-    ) -> AsyncTaskLink:
+    ) -> TaskHelper[BulkUpdateDnaSequencesAsyncTaskResponse]:
         """
         Bulk create or update DNA sequences.
 
@@ -356,7 +363,7 @@ class DnaSequenceService(BaseService):
         response = bulk_upsert_dna_sequences.sync_detailed(
             client=self.client, json_body=body, returning=none_as_unset(returning_string)
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateDnaSequencesAsyncTaskResponse)
 
     @api_method
     def match_bases(self, match_bases_request: MatchBasesRequest) -> DnaSequencesPaginatedList:
@@ -390,7 +397,9 @@ class DnaSequenceService(BaseService):
         return model_from_detailed(response)
 
     @api_method
-    def find_matching_regions(self, find_matching_region: DnaSequencesFindMatchingRegion) -> AsyncTaskLink:
+    def find_matching_regions(
+        self, find_matching_region: DnaSequencesFindMatchingRegion
+    ) -> TaskHelper[FindMatchingRegionsDnaAsyncTaskResponse]:
         """
         Find matching regions for DNA sequences.
 
@@ -399,14 +408,14 @@ class DnaSequenceService(BaseService):
         response = find_matching_regions_dna_sequences.sync_detailed(
             client=self.client, json_body=find_matching_region
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, FindMatchingRegionsDnaAsyncTaskResponse)
 
     @api_method
-    def optimize_codons(self, optimize_request: OptimizeCodons) -> AsyncTaskLink:
+    def optimize_codons(self, optimize_request: OptimizeCodons) -> TaskHelper[EmptyTaskResponse]:
         """
         Create codon-optimized DNA sequences.
 
         See https://benchling.com/api/reference#/DNA%20Sequences/optimizeCodons
         """
         response = optimize_codons.sync_detailed(client=self.client, json_body=optimize_request)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)

benchling_sdk/services/v2/stable/export_service.py

@@ -1,8 +1,8 @@
 from benchling_api_client.v2.stable.api.exports import export_item
 
 from benchling_sdk.helpers.decorators import api_method
-from benchling_sdk.helpers.response_helpers import model_from_detailed
-from benchling_sdk.models import AsyncTaskLink, ExportItemRequest
+from benchling_sdk.helpers.task_helpers import TaskHelper
+from benchling_sdk.models import ExportItemRequest, ExportsAsyncTaskResponse
 from benchling_sdk.services.v2.base_service import BaseService
 
 
@@ -16,7 +16,7 @@ class ExportService(BaseService):
     """
 
     @api_method
-    def export(self, export_request: ExportItemRequest) -> AsyncTaskLink:
+    def export(self, export_request: ExportItemRequest) -> TaskHelper[ExportsAsyncTaskResponse]:
         """
         Export a Notebook Entry.
 
@@ -27,4 +27,4 @@ class ExportService(BaseService):
         See https://benchling.com/api/reference#/Exports/exportItem
         """
         response = export_item.sync_detailed(client=self.client, json_body=export_request)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, ExportsAsyncTaskResponse)

benchling_sdk/services/v2/stable/feature_library_service.py

@@ -19,8 +19,9 @@ from benchling_sdk.helpers.decorators import api_method
 from benchling_sdk.helpers.pagination_helpers import NextToken, PageIterator
 from benchling_sdk.helpers.response_helpers import model_from_detailed
 from benchling_sdk.helpers.serialization_helpers import none_as_unset, optional_array_query_param
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
+    BulkCreateFeaturesAsyncTaskResponse,
     Feature,
     FeatureBulkCreate,
     FeatureCreate,
@@ -244,7 +245,9 @@ class FeatureLibraryService(BaseService):
         return model_from_detailed(response)
 
     @api_method
-    def bulk_create_features(self, features: Iterable[FeatureBulkCreate]) -> AsyncTaskLink:
+    def bulk_create_features(
+        self, features: Iterable[FeatureBulkCreate]
+    ) -> TaskHelper[BulkCreateFeaturesAsyncTaskResponse]:
         """
         Bulk create features.
 
@@ -252,4 +255,4 @@ class FeatureLibraryService(BaseService):
         """
         body = FeaturesBulkCreateRequest(list(features))
         response = bulk_create_features.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkCreateFeaturesAsyncTaskResponse)

benchling_sdk/services/v2/stable/lab_automation_service.py

@@ -21,8 +21,8 @@ from benchling_sdk.helpers.decorators import api_method
 from benchling_sdk.helpers.pagination_helpers import NextToken, PageIterator
 from benchling_sdk.helpers.response_helpers import model_from_detailed
 from benchling_sdk.helpers.serialization_helpers import none_as_unset
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
     AutomationInputGenerator,
     AutomationInputGeneratorUpdate,
     AutomationOutputProcessor,
@@ -101,7 +101,7 @@ class LabAutomationService(BaseService):
         return model_from_detailed(response)
 
     @api_method
-    def generate_input(self, input_generator_id: str) -> AsyncTaskLink:
+    def generate_input(self, input_generator_id: str) -> TaskHelper[AutomationInputGenerator]:
         """
         Generate input with an Automation Input Generator.
 
@@ -110,10 +110,10 @@ class LabAutomationService(BaseService):
         response = generate_input_with_automation_input_generator.sync_detailed(
             client=self.client, input_generator_id=input_generator_id
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, AutomationInputGenerator)
 
     @api_method
-    def process_output(self, output_processor_id: str) -> AsyncTaskLink:
+    def process_output(self, output_processor_id: str) -> TaskHelper[AutomationOutputProcessor]:
         """
         Process output with an Automation Output Processor.
 
@@ -122,7 +122,7 @@ class LabAutomationService(BaseService):
         response = process_output_with_automation_output_processor.sync_detailed(
             client=self.client, output_processor_id=output_processor_id
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, AutomationOutputProcessor)
 
     @api_method
     def _automation_output_processors_page(

benchling_sdk/services/v2/stable/nucleotide_alignments_service.py

@@ -15,8 +15,8 @@ from benchling_sdk.helpers.decorators import api_method
 from benchling_sdk.helpers.pagination_helpers import NextToken, PageIterator
 from benchling_sdk.helpers.response_helpers import model_from_detailed
 from benchling_sdk.helpers.serialization_helpers import none_as_unset, optional_array_query_param
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
     ListNucleotideAlignmentsSort,
     NucleotideAlignment,
     NucleotideAlignmentsPaginatedList,
@@ -118,7 +118,7 @@ class NucleotideAlignmentsService(BaseService):
     @api_method
     def create_template_alignment(
         self, template_alignment: NucleotideTemplateAlignmentCreate
-    ) -> AsyncTaskLink:
+    ) -> TaskHelper[NucleotideAlignment]:
         """
         Create a template Nucleotide alignment.
 
@@ -127,12 +127,12 @@ class NucleotideAlignmentsService(BaseService):
         response = create_template_nucleotide_alignment.sync_detailed(
             client=self.client, json_body=template_alignment
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, NucleotideAlignment)
 
     @api_method
     def create_consensus_alignment(
         self, consensus_alignment: NucleotideConsensusAlignmentCreate
-    ) -> AsyncTaskLink:
+    ) -> TaskHelper[NucleotideAlignment]:
         """
         Create a consensus Nucleotide alignment.
 
@@ -141,7 +141,7 @@ class NucleotideAlignmentsService(BaseService):
         response = create_consensus_nucleotide_alignment.sync_detailed(
             client=self.client, json_body=consensus_alignment
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, NucleotideAlignment)
 
     @api_method
     def delete_alignment(self, alignment_id: str) -> None:

benchling_sdk/services/v2/stable/oligo_service.py

@@ -23,8 +23,9 @@ from benchling_sdk.helpers.serialization_helpers import (
     optional_array_query_param,
     schema_fields_query_param,
 )
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
+    BulkCreateDnaOligosAsyncTaskResponse,
     DnaOligo,
     EntityArchiveReason,
     ListOligosSort,
@@ -269,7 +270,7 @@ class OligoService(BaseService):
         return oligos_results.oligos
 
     @api_method
-    def bulk_create(self, oligos: Iterable[OligoCreate]) -> AsyncTaskLink:
+    def bulk_create(self, oligos: Iterable[OligoCreate]) -> TaskHelper[BulkCreateDnaOligosAsyncTaskResponse]:
         """
         Bulk create DNA Oligos (Deprecated).
 
@@ -282,4 +283,4 @@ class OligoService(BaseService):
         log_deprecation("oligos.bulk_create", "dna_oligos.bulk_create or rna_oligos.bulk_create")
         body = OligosBulkCreateRequest(list(oligos))
         response = bulk_create_oligos.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkCreateDnaOligosAsyncTaskResponse)

benchling_sdk/services/v2/stable/registry_service.py

@@ -13,9 +13,9 @@ from benchling_sdk.helpers.decorators import api_method
 from benchling_sdk.helpers.logging_helpers import check_for_csv_bug_fix
 from benchling_sdk.helpers.response_helpers import model_from_detailed
 from benchling_sdk.helpers.serialization_helpers import array_query_param
+from benchling_sdk.helpers.task_helpers import EmptyTaskResponse, TaskHelper
 from benchling_sdk.models import (
     AaSequenceWithEntityType,
-    AsyncTaskLink,
     CustomEntityWithEntityType,
     DnaOligoWithEntityType,
     DnaSequenceWithEntityType,
@@ -54,7 +54,7 @@ class RegistryService(BaseService):
         registry_id: str,
         entity_ids: Iterable[str],
         naming_strategy: NamingStrategy = NamingStrategy.NEW_IDS,
-    ) -> AsyncTaskLink:
+    ) -> TaskHelper[EmptyTaskResponse]:
         """
         Register entities.
 
@@ -70,7 +70,7 @@ class RegistryService(BaseService):
         response = register_entities.sync_detailed(
             client=self.client, registry_id=registry_id, json_body=registration_body
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, EmptyTaskResponse)
 
     @api_method
     def unregister(

benchling_sdk/services/v2/stable/rna_oligo_service.py

@@ -24,8 +24,10 @@ from benchling_sdk.helpers.serialization_helpers import (
     optional_array_query_param,
     schema_fields_query_param,
 )
+from benchling_sdk.helpers.task_helpers import TaskHelper
 from benchling_sdk.models import (
-    AsyncTaskLink,
+    BulkCreateRnaOligosAsyncTaskResponse,
+    BulkUpdateRnaOligosAsyncTaskResponse,
     EntityArchiveReason,
     ListRNAOligosSort,
     OligoUpsertRequest,
@@ -236,7 +238,9 @@ class RnaOligoService(BaseService):
         return model_from_detailed(response)
 
     @api_method
-    def bulk_create(self, rna_oligos: Iterable[RnaOligoCreate]) -> AsyncTaskLink:
+    def bulk_create(
+        self, rna_oligos: Iterable[RnaOligoCreate]
+    ) -> TaskHelper[BulkCreateRnaOligosAsyncTaskResponse]:
         """
         Bulk create RNA Oligos.
 
@@ -244,10 +248,12 @@ class RnaOligoService(BaseService):
         """
         body = RnaOligosBulkCreateRequest(list(rna_oligos))
         response = bulk_create_rna_oligos.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkCreateRnaOligosAsyncTaskResponse)
 
     @api_method
-    def bulk_update(self, rna_oligos: Iterable[RnaOligoBulkUpdate]) -> AsyncTaskLink:
+    def bulk_update(
+        self, rna_oligos: Iterable[RnaOligoBulkUpdate]
+    ) -> TaskHelper[BulkUpdateRnaOligosAsyncTaskResponse]:
         """
         Bulk update RNA oligos.
 
@@ -255,7 +261,7 @@ class RnaOligoService(BaseService):
         """
         body = RnaOligosBulkUpdateRequest(list(rna_oligos))
         response = bulk_update_rna_oligos.sync_detailed(client=self.client, json_body=body)
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateRnaOligosAsyncTaskResponse)
 
     @api_method
     def upsert(self, entity_registry_id: str, rna_oligo: OligoUpsertRequest) -> RnaOligo:
@@ -272,7 +278,7 @@ class RnaOligoService(BaseService):
     @api_method
     def bulk_upsert(
         self, body: RnaOligosBulkUpsertRequest, returning: Optional[Iterable[str]] = None
-    ) -> AsyncTaskLink:
+    ) -> TaskHelper[BulkUpdateRnaOligosAsyncTaskResponse]:
         """
         Bulk create or update RNA Oligos.
 
@@ -282,4 +288,4 @@ class RnaOligoService(BaseService):
         response = bulk_upsert_rna_oligos.sync_detailed(
             client=self.client, json_body=body, returning=none_as_unset(returning_string)
         )
-        return model_from_detailed(response)
+        return self._task_helper_from_response(response, BulkUpdateRnaOligosAsyncTaskResponse)