benchling-v3-sdk-python 5.0.0__py3-none-any.whl

benchling_v3_sdk/protein/client.py

@@ -0,0 +1,2215 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.pagination import AsyncPager, SyncPager
+from ..core.request_options import RequestOptions
+from ..types.async_task_link import AsyncTaskLink
+from ..types.create_protein_input import CreateProteinInput
+from ..types.create_protein_input_naming_strategy import CreateProteinInputNamingStrategy
+from ..types.field_value_input import FieldValueInput
+from ..types.principal_unpaginated_list import PrincipalUnpaginatedList
+from ..types.protein import Protein
+from ..types.protein_chain_input import ProteinChainInput
+from ..types.protein_domain_input import ProteinDomainInput
+from ..types.protein_paginated_list import ProteinPaginatedList
+from ..types.protein_version import ProteinVersion
+from ..types.protein_version_paginated_list import ProteinVersionPaginatedList
+from ..types.update_protein_input_with_path_params import UpdateProteinInputWithPathParams
+from .raw_client import AsyncRawProteinClient, RawProteinClient
+from .types.batch_create_protein_response import BatchCreateProteinResponse
+from .types.batch_update_protein_response import BatchUpdateProteinResponse
+from .types.bulk_create_and_register_proteins_and_components_protein_request_germline_configs_item import (
+    BulkCreateAndRegisterProteinsAndComponentsProteinRequestGermlineConfigsItem,
+)
+from .types.bulk_create_and_register_proteins_and_components_protein_request_new_component_config import (
+    BulkCreateAndRegisterProteinsAndComponentsProteinRequestNewComponentConfig,
+)
+from .types.bulk_create_and_register_proteins_and_components_protein_request_protein_create_inputs_item import (
+    BulkCreateAndRegisterProteinsAndComponentsProteinRequestProteinCreateInputsItem,
+)
+from .types.bulk_create_and_register_proteins_and_components_protein_request_translation_parameters import (
+    BulkCreateAndRegisterProteinsAndComponentsProteinRequestTranslationParameters,
+)
+from .types.bulk_create_and_register_proteins_and_components_protein_response import (
+    BulkCreateAndRegisterProteinsAndComponentsProteinResponse,
+)
+from .types.get_results_for_bulk_create_and_register_proteins_and_components_protein_response import (
+    GetResultsForBulkCreateAndRegisterProteinsAndComponentsProteinResponse,
+)
+from .types.get_task_for_bulk_create_and_register_proteins_and_components_protein_response import (
+    GetTaskForBulkCreateAndRegisterProteinsAndComponentsProteinResponse,
+)
+from .types.list_full_history_protein_request_sort import ListFullHistoryProteinRequestSort
+from .types.list_history_protein_request_sort import ListHistoryProteinRequestSort
+from .types.list_protein_request_sort import ListProteinRequestSort
+from .types.update_protein_input_naming_strategy import UpdateProteinInputNamingStrategy
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class ProteinClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawProteinClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawProteinClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawProteinClient
+        """
+        return self._raw_client
+
+    def create(
+        self,
+        *,
+        chains: typing.Sequence[ProteinChainInput],
+        domains: typing.Sequence[ProteinDomainInput],
+        folder_id: str,
+        name: str,
+        schema_id: str,
+        aliases: typing.Optional[typing.Sequence[str]] = OMIT,
+        author_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        custom_fields: typing.Optional[typing.Dict[str, FieldValueInput]] = OMIT,
+        entity_registry_id: typing.Optional[str] = OMIT,
+        naming_strategy: typing.Optional[CreateProteinInputNamingStrategy] = OMIT,
+        registry_id: typing.Optional[str] = OMIT,
+        schema_fields: typing.Optional[typing.Dict[str, FieldValueInput]] = OMIT,
+        study_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Protein:
+        """
+        Create Protein.
+
+        Parameters
+        ----------
+        chains : typing.Sequence[ProteinChainInput]
+            A chain input for each chain on the relevant format. All must be provided.
+
+        domains : typing.Sequence[ProteinDomainInput]
+            A domain input for each domain on the relevant format. All must be provided.
+
+        folder_id : str
+
+        name : str
+            Name of the item.
+
+        schema_id : str
+            The ID of the schema to create the protein in.
+
+        aliases : typing.Optional[typing.Sequence[str]]
+
+        author_ids : typing.Optional[typing.Sequence[str]]
+
+        custom_fields : typing.Optional[typing.Dict[str, FieldValueInput]]
+
+        entity_registry_id : typing.Optional[str]
+            Registry ID to assign to the entity. If one is specified, the labeling_strategy must be unspecified.
+
+        naming_strategy : typing.Optional[CreateProteinInputNamingStrategy]
+            Strategy to use for labeling the item in the registry. If one is specified, the entity_registry_id must be unspecified.
+
+        registry_id : typing.Optional[str]
+            A not null value means the entity should be registered. If not null, the value must match the registry of the item's schema.
+
+        schema_fields : typing.Optional[typing.Dict[str, FieldValueInput]]
+
+        study_ids : typing.Optional[typing.Sequence[str]]
+            Study IDs to add the new protein to.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Protein
+            Created
+
+        Examples
+        --------
+        from benchling_v3_sdk import Benchling, ProteinChainInput, ProteinDomainInput
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        client.protein.create(
+            chains=[
+                ProteinChainInput(
+                    aa_sequence_id="aaSequenceId",
+                    label="label",
+                )
+            ],
+            domains=[
+                ProteinDomainInput(
+                    aa_sequence_id="aaSequenceId",
+                    label="label",
+                )
+            ],
+            folder_id="folderId",
+            name="name",
+            schema_id="schemaId",
+        )
+        """
+        _response = self._raw_client.create(
+            chains=chains,
+            domains=domains,
+            folder_id=folder_id,
+            name=name,
+            schema_id=schema_id,
+            aliases=aliases,
+            author_ids=author_ids,
+            custom_fields=custom_fields,
+            entity_registry_id=entity_registry_id,
+            naming_strategy=naming_strategy,
+            registry_id=registry_id,
+            schema_fields=schema_fields,
+            study_ids=study_ids,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def list(
+        self,
+        *,
+        archive_reason_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        archived_any_of: typing.Optional[typing.Union[bool, typing.Sequence[bool]]] = None,
+        authors_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        created_at_gt: typing.Optional[str] = None,
+        created_at_gte: typing.Optional[str] = None,
+        created_at_lt: typing.Optional[str] = None,
+        created_at_lte: typing.Optional[str] = None,
+        creator_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        entity_registry_ids_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        fieldset_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        folder_eq: typing.Optional[str] = None,
+        id_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        mentioned_in_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        modified_at_gt: typing.Optional[str] = None,
+        modified_at_gte: typing.Optional[str] = None,
+        modified_at_lt: typing.Optional[str] = None,
+        modified_at_lte: typing.Optional[str] = None,
+        name_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        name_any_of_case_sensitive: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        next_token: typing.Optional[str] = None,
+        omit: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        page_size: typing.Optional[int] = None,
+        project_eq: typing.Optional[str] = None,
+        registry_eq: typing.Optional[str] = None,
+        returning: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        schema_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        schema_eq: typing.Optional[str] = None,
+        system_category_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        sort: typing.Optional[ListProteinRequestSort] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SyncPager[Protein, ProteinPaginatedList]:
+        """
+        List Protein items.
+
+        Parameters
+        ----------
+        archive_reason_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts items to those with any of the specified archive reasons. Use "NOT_ARCHIVED" to filter for unarchived items. Use "ANY_ARCHIVED" to filter for archived items regardless of reason. Use "ANY_ARCHIVED_OR_NOT_ARCHIVED" to return items for both archived and unarchived. Comma-separated list.
+
+        archived_any_of : typing.Optional[typing.Union[bool, typing.Sequence[bool]]]
+            If true, returns archived items. If false, returns unarchived items. If both true and false, returns archived and unarchived items. Comma-separated list.
+
+        authors_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those whose author matches any of the specified user or author IDs. Comma-separated list.
+
+        created_at_gt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created after the specified time. e.g. > 2017-04-30.
+
+        created_at_gte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created at or after the specified time. e.g. >= 2017-04-30.
+
+        created_at_lt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created before the specified time. e.g. < 2017-04-30.
+
+        created_at_lte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created at or before the specified time. e.g. <= 2017-04-30.
+
+        creator_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those created by any of the specified user IDs. Comma-separated list.
+
+        entity_registry_ids_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those that match any of the specified entity registry IDs. Comma-separated list.
+
+        fieldset_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those whose schema implements any of the specified fieldset API IDs (custom schema interfaces). Comma-separated list.
+
+        folder_eq : typing.Optional[str]
+            ID of a folder. Restricts results to its direct children.
+
+        id_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those matching any of the specified IDs. Comma-separated list.
+
+        mentioned_in_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to items mentioned in entries matching any of the specified entry IDs. Comma-separated list.
+
+        modified_at_gt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those modified after the specified time. e.g. > 2017-04-30.
+
+        modified_at_gte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those modified at or after the specified time. e.g. >= 2017-04-30.
+
+        modified_at_lt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those modified before the specified time. e.g. < 2017-04-30.
+
+        modified_at_lte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those modified at or before the specified time. e.g. <= 2017-04-30.
+
+        name_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those that match any of the specified names. Case insensitive. Warning - this filter can be non-performant due to case insensitivity. Ensure only one name filter is used at a time. Comma-separated list.
+
+        name_any_of_case_sensitive : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those that match any of the specified names. Case sensitive. Ensure only one name filter is used at a time. Comma-separated list.
+
+        next_token : typing.Optional[str]
+            Token for pagination
+
+        omit : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Comma-separated list of top-level fields to omit from each returned item. Cannot overlap with returning.
+
+        page_size : typing.Optional[int]
+            Number of results to return. Defaults to 50, maximum of 100.
+
+        project_eq : typing.Optional[str]
+            ID of a project. Restricts results to those in the project.
+
+        registry_eq : typing.Optional[str]
+            ID of a registry. Restricts results to those registered in this registry. Specifying "null" returns unregistered items.
+
+        returning : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Comma-separated list of top-level fields to include in each returned item. Cannot overlap with omit.
+
+        schema_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those that match any of the specified schema IDs. Use only one `schema` filter arg at a time. Comma-separated list.
+
+        schema_eq : typing.Optional[str]
+            Single schema ID. Restricts results to those that match the specified schema exactly. Use only one `schema` filter arg at a time.
+
+        system_category_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those whose schema implements any of the specified system category API IDs (non-exclusive static schema interfaces). Comma-separated list.
+
+        sort : typing.Optional[ListProteinRequestSort]
+            Method by which to order results. Valid sorts are: createdAt (created time, oldest first) and modifiedAt (modified time, oldest first). Use :asc or :desc to specify ascending or descending order. Default is modifiedAt:desc.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SyncPager[Protein, ProteinPaginatedList]
+            OK
+
+        Examples
+        --------
+        from benchling_v3_sdk import Benchling
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        response = client.protein.list()
+        for item in response:
+            yield item
+        # alternatively, you can paginate page-by-page
+        for page in response.iter_pages():
+            yield page
+        """
+        return self._raw_client.list(
+            archive_reason_any_of=archive_reason_any_of,
+            archived_any_of=archived_any_of,
+            authors_any_of=authors_any_of,
+            created_at_gt=created_at_gt,
+            created_at_gte=created_at_gte,
+            created_at_lt=created_at_lt,
+            created_at_lte=created_at_lte,
+            creator_any_of=creator_any_of,
+            entity_registry_ids_any_of=entity_registry_ids_any_of,
+            fieldset_any_of=fieldset_any_of,
+            folder_eq=folder_eq,
+            id_any_of=id_any_of,
+            mentioned_in_any_of=mentioned_in_any_of,
+            modified_at_gt=modified_at_gt,
+            modified_at_gte=modified_at_gte,
+            modified_at_lt=modified_at_lt,
+            modified_at_lte=modified_at_lte,
+            name_any_of=name_any_of,
+            name_any_of_case_sensitive=name_any_of_case_sensitive,
+            next_token=next_token,
+            omit=omit,
+            page_size=page_size,
+            project_eq=project_eq,
+            registry_eq=registry_eq,
+            returning=returning,
+            schema_any_of=schema_any_of,
+            schema_eq=schema_eq,
+            system_category_any_of=system_category_any_of,
+            sort=sort,
+            request_options=request_options,
+        )
+
+    def get(
+        self,
+        protein_id: str,
+        *,
+        returning: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        omit: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Protein:
+        """
+        Get a single Protein by ID.
+
+        Parameters
+        ----------
+        protein_id : str
+            ID of the Protein.
+
+        returning : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Comma-separated list of top-level fields to include in each returned item. Cannot overlap with omit.
+
+        omit : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Comma-separated list of top-level fields to omit from each returned item. Cannot overlap with returning.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Protein
+            OK
+
+        Examples
+        --------
+        from benchling_v3_sdk import Benchling
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        client.protein.get(
+            protein_id="protein_id",
+        )
+        """
+        _response = self._raw_client.get(protein_id, returning=returning, omit=omit, request_options=request_options)
+        return _response.data
+
+    def update(
+        self,
+        protein_id: str,
+        *,
+        aliases: typing.Optional[typing.Sequence[str]] = OMIT,
+        archive_reason: typing.Optional[str] = OMIT,
+        archived: typing.Optional[bool] = OMIT,
+        author_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        chains: typing.Optional[typing.Sequence[ProteinChainInput]] = OMIT,
+        custom_fields: typing.Optional[typing.Dict[str, FieldValueInput]] = OMIT,
+        domains: typing.Optional[typing.Sequence[ProteinDomainInput]] = OMIT,
+        entity_registry_id: typing.Optional[str] = OMIT,
+        folder_id: typing.Optional[str] = OMIT,
+        name: typing.Optional[str] = OMIT,
+        naming_strategy: typing.Optional[UpdateProteinInputNamingStrategy] = OMIT,
+        registry_id: typing.Optional[str] = OMIT,
+        schema_fields: typing.Optional[typing.Dict[str, FieldValueInput]] = OMIT,
+        schema_id: typing.Optional[str] = OMIT,
+        study_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Protein:
+        """
+        Update Protein.
+
+        Parameters
+        ----------
+        protein_id : str
+            ID of the Protein.
+
+        aliases : typing.Optional[typing.Sequence[str]]
+
+        archive_reason : typing.Optional[str]
+
+        archived : typing.Optional[bool]
+
+        author_ids : typing.Optional[typing.Sequence[str]]
+
+        chains : typing.Optional[typing.Sequence[ProteinChainInput]]
+            A chain input for each chain on the relevant format. Must be all provided if domains are provided.
+
+        custom_fields : typing.Optional[typing.Dict[str, FieldValueInput]]
+
+        domains : typing.Optional[typing.Sequence[ProteinDomainInput]]
+            A domain input for each domain on the relevant format. If any are provided, all must be provided.
+
+        entity_registry_id : typing.Optional[str]
+            Registry ID to assign to the entity. When registering, specifying this value sets the registry ID of the entity. When already registered, specifying this value updates the entity's registry ID. If set, naming_strategy must be unspecified.
+
+        folder_id : typing.Optional[str]
+
+        name : typing.Optional[str]
+            Name of the item.
+
+        naming_strategy : typing.Optional[UpdateProteinInputNamingStrategy]
+            Strategy to use for labeling the item in the registry if registering. If one is specified, the entity_registry_id must be unspecified.
+
+        registry_id : typing.Optional[str]
+            A not null value means the entity should be registered. A null value means it should be unregistered. If not null, the value must match the registry of the item's schema.
+
+        schema_fields : typing.Optional[typing.Dict[str, FieldValueInput]]
+
+        schema_id : typing.Optional[str]
+
+        study_ids : typing.Optional[typing.Sequence[str]]
+            Study IDs to add the protein to.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Protein
+            OK
+
+        Examples
+        --------
+        from benchling_v3_sdk import Benchling
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        client.protein.update(
+            protein_id="protein_id",
+        )
+        """
+        _response = self._raw_client.update(
+            protein_id,
+            aliases=aliases,
+            archive_reason=archive_reason,
+            archived=archived,
+            author_ids=author_ids,
+            chains=chains,
+            custom_fields=custom_fields,
+            domains=domains,
+            entity_registry_id=entity_registry_id,
+            folder_id=folder_id,
+            name=name,
+            naming_strategy=naming_strategy,
+            registry_id=registry_id,
+            schema_fields=schema_fields,
+            schema_id=schema_id,
+            study_ids=study_ids,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def list_authors(
+        self, protein_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> PrincipalUnpaginatedList:
+        """
+        List Principal items.
+
+        Parameters
+        ----------
+        protein_id : str
+            ID of the Protein.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        PrincipalUnpaginatedList
+            OK
+
+        Examples
+        --------
+        from benchling_v3_sdk import Benchling
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        client.protein.list_authors(
+            protein_id="protein_id",
+        )
+        """
+        _response = self._raw_client.list_authors(protein_id, request_options=request_options)
+        return _response.data
+
+    def list_full_history(
+        self,
+        protein_id: str,
+        *,
+        created_at_gt: typing.Optional[str] = None,
+        created_at_gte: typing.Optional[str] = None,
+        created_at_lt: typing.Optional[str] = None,
+        created_at_lte: typing.Optional[str] = None,
+        id_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        next_token: typing.Optional[str] = None,
+        page_size: typing.Optional[int] = None,
+        protein_history_eq: typing.Optional[str] = None,
+        sort: typing.Optional[ListFullHistoryProteinRequestSort] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SyncPager[ProteinVersion, ProteinVersionPaginatedList]:
+        """
+        List ProteinVersion items.
+
+        Parameters
+        ----------
+        protein_id : str
+            ID of the Protein.
+
+        created_at_gt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created after the specified time. e.g. > 2017-04-30.
+
+        created_at_gte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created at or after the specified time. e.g. >= 2017-04-30.
+
+        created_at_lt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created before the specified time. e.g. < 2017-04-30.
+
+        created_at_lte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created at or before the specified time. e.g. <= 2017-04-30.
+
+        id_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those matching any of the specified IDs. Comma-separated list.
+
+        next_token : typing.Optional[str]
+            Token for pagination
+
+        page_size : typing.Optional[int]
+            Number of results to return. Defaults to 50, maximum of 100.
+
+        protein_history_eq : typing.Optional[str]
+            ID of the Protein that owns the version.
+
+        sort : typing.Optional[ListFullHistoryProteinRequestSort]
+            Method by which to order results. Valid sorts are: createdAt (created time, oldest first). Use :asc or :desc to specify ascending or descending order. Default is createdAt:asc.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SyncPager[ProteinVersion, ProteinVersionPaginatedList]
+            OK
+
+        Examples
+        --------
+        from benchling_v3_sdk import Benchling
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        response = client.protein.list_full_history(
+            protein_id="protein_id",
+        )
+        for item in response:
+            yield item
+        # alternatively, you can paginate page-by-page
+        for page in response.iter_pages():
+            yield page
+        """
+        return self._raw_client.list_full_history(
+            protein_id,
+            created_at_gt=created_at_gt,
+            created_at_gte=created_at_gte,
+            created_at_lt=created_at_lt,
+            created_at_lte=created_at_lte,
+            id_any_of=id_any_of,
+            next_token=next_token,
+            page_size=page_size,
+            protein_history_eq=protein_history_eq,
+            sort=sort,
+            request_options=request_options,
+        )
+
+    def list_history(
+        self,
+        protein_id: str,
+        *,
+        created_at_gt: typing.Optional[str] = None,
+        created_at_gte: typing.Optional[str] = None,
+        created_at_lt: typing.Optional[str] = None,
+        created_at_lte: typing.Optional[str] = None,
+        id_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        next_token: typing.Optional[str] = None,
+        page_size: typing.Optional[int] = None,
+        protein_full_history_eq: typing.Optional[str] = None,
+        sort: typing.Optional[ListHistoryProteinRequestSort] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SyncPager[ProteinVersion, ProteinVersionPaginatedList]:
+        """
+        List ProteinVersion items.
+
+        Parameters
+        ----------
+        protein_id : str
+            ID of the Protein.
+
+        created_at_gt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created after the specified time. e.g. > 2017-04-30.
+
+        created_at_gte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created at or after the specified time. e.g. >= 2017-04-30.
+
+        created_at_lt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created before the specified time. e.g. < 2017-04-30.
+
+        created_at_lte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created at or before the specified time. e.g. <= 2017-04-30.
+
+        id_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those matching any of the specified IDs. Comma-separated list.
+
+        next_token : typing.Optional[str]
+            Token for pagination
+
+        page_size : typing.Optional[int]
+            Number of results to return. Defaults to 50, maximum of 100.
+
+        protein_full_history_eq : typing.Optional[str]
+            ID of the Protein that owns the version.
+
+        sort : typing.Optional[ListHistoryProteinRequestSort]
+            Method by which to order results. Valid sorts are: createdAt (created time, oldest first). Use :asc or :desc to specify ascending or descending order. Default is createdAt:asc.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SyncPager[ProteinVersion, ProteinVersionPaginatedList]
+            OK
+
+        Examples
+        --------
+        from benchling_v3_sdk import Benchling
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        response = client.protein.list_history(
+            protein_id="protein_id",
+        )
+        for item in response:
+            yield item
+        # alternatively, you can paginate page-by-page
+        for page in response.iter_pages():
+            yield page
+        """
+        return self._raw_client.list_history(
+            protein_id,
+            created_at_gt=created_at_gt,
+            created_at_gte=created_at_gte,
+            created_at_lt=created_at_lt,
+            created_at_lte=created_at_lte,
+            id_any_of=id_any_of,
+            next_token=next_token,
+            page_size=page_size,
+            protein_full_history_eq=protein_full_history_eq,
+            sort=sort,
+            request_options=request_options,
+        )
+
+    def batch_create(
+        self, *, items: typing.Sequence[CreateProteinInput], request_options: typing.Optional[RequestOptions] = None
+    ) -> BatchCreateProteinResponse:
+        """
+        Batch create Protein synchronously in one transaction. Maximum 25 items per request.
+
+        Parameters
+        ----------
+        items : typing.Sequence[CreateProteinInput]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        BatchCreateProteinResponse
+            Created
+
+        Examples
+        --------
+        from benchling_v3_sdk import (
+            Benchling,
+            CreateProteinInput,
+            ProteinChainInput,
+            ProteinDomainInput,
+        )
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        client.protein.batch_create(
+            items=[
+                CreateProteinInput(
+                    chains=[
+                        ProteinChainInput(
+                            aa_sequence_id="aaSequenceId",
+                            label="label",
+                        )
+                    ],
+                    domains=[
+                        ProteinDomainInput(
+                            aa_sequence_id="aaSequenceId",
+                            label="label",
+                        )
+                    ],
+                    folder_id="folderId",
+                    name="name",
+                    schema_id="schemaId",
+                )
+            ],
+        )
+        """
+        _response = self._raw_client.batch_create(items=items, request_options=request_options)
+        return _response.data
+
+    def batch_update(
+        self,
+        *,
+        items: typing.Sequence[UpdateProteinInputWithPathParams],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> BatchUpdateProteinResponse:
+        """
+        Batch update Protein synchronously in one transaction. Maximum 25 items per request.
+
+        Parameters
+        ----------
+        items : typing.Sequence[UpdateProteinInputWithPathParams]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        BatchUpdateProteinResponse
+            OK
+
+        Examples
+        --------
+        from benchling_v3_sdk import Benchling, UpdateProteinInputWithPathParams
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        client.protein.batch_update(
+            items=[
+                UpdateProteinInputWithPathParams(
+                    id="id",
+                )
+            ],
+        )
+        """
+        _response = self._raw_client.batch_update(items=items, request_options=request_options)
+        return _response.data
+
+    def bulk_create(self, *, file_id: str, request_options: typing.Optional[RequestOptions] = None) -> AsyncTaskLink:
+        """
+        Bulk create Protein.
+
+        Parameters
+        ----------
+        file_id : str
+            The API ID of the scratch file (`scrfile_XXXXXXXX`) containing the items to import. The referenced file must be a scratch file whose upload has completed successfully.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncTaskLink
+            Task started
+
+        Examples
+        --------
+        from benchling_v3_sdk import Benchling
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        client.protein.bulk_create(
+            file_id="scrfile_jdf8BV24kLmN",
+        )
+        """
+        _response = self._raw_client.bulk_create(file_id=file_id, request_options=request_options)
+        return _response.data
+
+    def bulk_update(self, *, file_id: str, request_options: typing.Optional[RequestOptions] = None) -> AsyncTaskLink:
+        """
+        Bulk update Protein.
+
+        Parameters
+        ----------
+        file_id : str
+            The API ID of the scratch file (`scrfile_XXXXXXXX`) containing the items to import. The referenced file must be a scratch file whose upload has completed successfully.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncTaskLink
+            Task started
+
+        Examples
+        --------
+        from benchling_v3_sdk import Benchling
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        client.protein.bulk_update(
+            file_id="scrfile_jdf8BV24kLmN",
+        )
+        """
+        _response = self._raw_client.bulk_update(file_id=file_id, request_options=request_options)
+        return _response.data
+
+    def bulk_create_and_register_proteins_and_components(
+        self,
+        *,
+        folder_id: str,
+        new_component_config: BulkCreateAndRegisterProteinsAndComponentsProteinRequestNewComponentConfig,
+        protein_create_inputs: typing.Sequence[
+            BulkCreateAndRegisterProteinsAndComponentsProteinRequestProteinCreateInputsItem
+        ],
+        protein_schema_id: str,
+        entry_id: typing.Optional[str] = OMIT,
+        germline_configs: typing.Optional[
+            typing.Sequence[BulkCreateAndRegisterProteinsAndComponentsProteinRequestGermlineConfigsItem]
+        ] = OMIT,
+        translation_parameters: typing.Optional[
+            BulkCreateAndRegisterProteinsAndComponentsProteinRequestTranslationParameters
+        ] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> BulkCreateAndRegisterProteinsAndComponentsProteinResponse:
+        """
+        Create and register proteins and their component parts (domains, chains, and variable pairs)
+
+        Parameters
+        ----------
+        folder_id : str
+            The ID of the folder in which the new entities should be created.
+
+        new_component_config : BulkCreateAndRegisterProteinsAndComponentsProteinRequestNewComponentConfig
+            Schema IDs for new component entities created during this request.
+            Applies to all rows in the request.
+
+        protein_create_inputs : typing.Sequence[BulkCreateAndRegisterProteinsAndComponentsProteinRequestProteinCreateInputsItem]
+
+        protein_schema_id : str
+            The schema ID for the protein entity type.
+
+        entry_id : typing.Optional[str]
+            The ID of the notebook entry into which the creation results will be embedded upon completion.
+            If omitted, no results are written to a notebook entry.
+
+        germline_configs : typing.Optional[typing.Sequence[BulkCreateAndRegisterProteinsAndComponentsProteinRequestGermlineConfigsItem]]
+            A list of germline configs indicating the germline with which to annotate each domain key.
+            This applies to all rows in the request.
+
+        translation_parameters : typing.Optional[BulkCreateAndRegisterProteinsAndComponentsProteinRequestTranslationParameters]
+            The translation parameters to use when creating AA sequences.
+            Required if the request contains DNA sequences.
+            May be omitted if the request contains only AA sequences.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        BulkCreateAndRegisterProteinsAndComponentsProteinResponse
+            Job status details
+
+        Examples
+        --------
+        from benchling_v3_sdk import Benchling
+        from benchling_v3_sdk.protein import (
+            BulkCreateAndRegisterProteinsAndComponentsProteinRequestNewComponentConfig,
+        )
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        client.protein.bulk_create_and_register_proteins_and_components(
+            folder_id="lib_lKsxK6",
+            new_component_config=BulkCreateAndRegisterProteinsAndComponentsProteinRequestNewComponentConfig(
+                aa_pair_schema_id="ts_aapair012",
+            ),
+            protein_create_inputs=[],
+            protein_schema_id="ts_XEUrLw",
+        )
+        """
+        _response = self._raw_client.bulk_create_and_register_proteins_and_components(
+            folder_id=folder_id,
+            new_component_config=new_component_config,
+            protein_create_inputs=protein_create_inputs,
+            protein_schema_id=protein_schema_id,
+            entry_id=entry_id,
+            germline_configs=germline_configs,
+            translation_parameters=translation_parameters,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def get_task_for_bulk_create_and_register_proteins_and_components(
+        self, task_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> GetTaskForBulkCreateAndRegisterProteinsAndComponentsProteinResponse:
+        """
+        Get the current status of a bulk-create-and-register-proteins-and-components task.
+        When a job reaches a `COMPLETED` status, you can call the
+        `GET /tasks/bulk-create-and-register-proteins-and-components/{task_id}/results`
+        endpoint to fetch task results and errors.
+
+        Task IDs for this endpoint remain queryable for 14 days after the
+        job is created.
+        After that TTL expires, this endpoint returns 404. Retrieve any status
+        and results you need before the task ID expires.
+
+        Parameters
+        ----------
+        task_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetTaskForBulkCreateAndRegisterProteinsAndComponentsProteinResponse
+            Job status details
+
+        Examples
+        --------
+        from benchling_v3_sdk import Benchling
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        client.protein.get_task_for_bulk_create_and_register_proteins_and_components(
+            task_id="task_id",
+        )
+        """
+        _response = self._raw_client.get_task_for_bulk_create_and_register_proteins_and_components(
+            task_id, request_options=request_options
+        )
+        return _response.data
+
+    def get_results_for_bulk_create_and_register_proteins_and_components(
+        self, task_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> GetResultsForBulkCreateAndRegisterProteinsAndComponentsProteinResponse:
+        """
+        Get the results of a completed bulk-create-and-register-proteins-and-components task.
+
+        This endpoint returns an identifier for the output dataset, plus an optional
+        pre-signed URL to download the errors file if any inputs failed validation.
+
+        Task IDs for this endpoint remain queryable for 14 days after the
+        job is created.
+        After that TTL expires, this endpoint returns 404. Retrieve the dataset
+        ID and any errors file URL you need before the task ID expires.
+
+        **Partial Success**: A job can complete with both successful and failed inputs. Always check
+        `errorsFileUrl` even when `datasetId` is present, since some inputs may have been rejected
+        while others were created successfully.
+
+        Behavior:
+        - Returns 400 unless the task has a COMPLETED status. While a task is running
+          you can poll the
+          `GET /tasks/bulk-create-and-register-proteins-and-components/{task_id}`
+          endpoint first and only call this endpoint once
+          `status == "COMPLETED"`. If the status becomes FAILED, this endpoint
+          will always return 400.
+        - If the task is in a COMPLETED status, returns parameters you can
+          use to fetch output and error data.  See the descriptions of the output
+          parameters for more detail.
+
+        Parameters
+        ----------
+        task_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetResultsForBulkCreateAndRegisterProteinsAndComponentsProteinResponse
+            Task results
+
+        Examples
+        --------
+        from benchling_v3_sdk import Benchling
+
+        client = Benchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        client.protein.get_results_for_bulk_create_and_register_proteins_and_components(
+            task_id="cprotjob:ana_fhlbqd",
+        )
+        """
+        _response = self._raw_client.get_results_for_bulk_create_and_register_proteins_and_components(
+            task_id, request_options=request_options
+        )
+        return _response.data
+
+
+class AsyncProteinClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawProteinClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawProteinClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawProteinClient
+        """
+        return self._raw_client
+
+    async def create(
+        self,
+        *,
+        chains: typing.Sequence[ProteinChainInput],
+        domains: typing.Sequence[ProteinDomainInput],
+        folder_id: str,
+        name: str,
+        schema_id: str,
+        aliases: typing.Optional[typing.Sequence[str]] = OMIT,
+        author_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        custom_fields: typing.Optional[typing.Dict[str, FieldValueInput]] = OMIT,
+        entity_registry_id: typing.Optional[str] = OMIT,
+        naming_strategy: typing.Optional[CreateProteinInputNamingStrategy] = OMIT,
+        registry_id: typing.Optional[str] = OMIT,
+        schema_fields: typing.Optional[typing.Dict[str, FieldValueInput]] = OMIT,
+        study_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Protein:
+        """
+        Create Protein.
+
+        Parameters
+        ----------
+        chains : typing.Sequence[ProteinChainInput]
+            A chain input for each chain on the relevant format. All must be provided.
+
+        domains : typing.Sequence[ProteinDomainInput]
+            A domain input for each domain on the relevant format. All must be provided.
+
+        folder_id : str
+
+        name : str
+            Name of the item.
+
+        schema_id : str
+            The ID of the schema to create the protein in.
+
+        aliases : typing.Optional[typing.Sequence[str]]
+
+        author_ids : typing.Optional[typing.Sequence[str]]
+
+        custom_fields : typing.Optional[typing.Dict[str, FieldValueInput]]
+
+        entity_registry_id : typing.Optional[str]
+            Registry ID to assign to the entity. If one is specified, the labeling_strategy must be unspecified.
+
+        naming_strategy : typing.Optional[CreateProteinInputNamingStrategy]
+            Strategy to use for labeling the item in the registry. If one is specified, the entity_registry_id must be unspecified.
+
+        registry_id : typing.Optional[str]
+            A not null value means the entity should be registered. If not null, the value must match the registry of the item's schema.
+
+        schema_fields : typing.Optional[typing.Dict[str, FieldValueInput]]
+
+        study_ids : typing.Optional[typing.Sequence[str]]
+            Study IDs to add the new protein to.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Protein
+            Created
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import (
+            AsyncBenchling,
+            ProteinChainInput,
+            ProteinDomainInput,
+        )
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            await client.protein.create(
+                chains=[
+                    ProteinChainInput(
+                        aa_sequence_id="aaSequenceId",
+                        label="label",
+                    )
+                ],
+                domains=[
+                    ProteinDomainInput(
+                        aa_sequence_id="aaSequenceId",
+                        label="label",
+                    )
+                ],
+                folder_id="folderId",
+                name="name",
+                schema_id="schemaId",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.create(
+            chains=chains,
+            domains=domains,
+            folder_id=folder_id,
+            name=name,
+            schema_id=schema_id,
+            aliases=aliases,
+            author_ids=author_ids,
+            custom_fields=custom_fields,
+            entity_registry_id=entity_registry_id,
+            naming_strategy=naming_strategy,
+            registry_id=registry_id,
+            schema_fields=schema_fields,
+            study_ids=study_ids,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def list(
+        self,
+        *,
+        archive_reason_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        archived_any_of: typing.Optional[typing.Union[bool, typing.Sequence[bool]]] = None,
+        authors_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        created_at_gt: typing.Optional[str] = None,
+        created_at_gte: typing.Optional[str] = None,
+        created_at_lt: typing.Optional[str] = None,
+        created_at_lte: typing.Optional[str] = None,
+        creator_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        entity_registry_ids_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        fieldset_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        folder_eq: typing.Optional[str] = None,
+        id_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        mentioned_in_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        modified_at_gt: typing.Optional[str] = None,
+        modified_at_gte: typing.Optional[str] = None,
+        modified_at_lt: typing.Optional[str] = None,
+        modified_at_lte: typing.Optional[str] = None,
+        name_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        name_any_of_case_sensitive: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        next_token: typing.Optional[str] = None,
+        omit: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        page_size: typing.Optional[int] = None,
+        project_eq: typing.Optional[str] = None,
+        registry_eq: typing.Optional[str] = None,
+        returning: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        schema_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        schema_eq: typing.Optional[str] = None,
+        system_category_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        sort: typing.Optional[ListProteinRequestSort] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncPager[Protein, ProteinPaginatedList]:
+        """
+        List Protein items.
+
+        Parameters
+        ----------
+        archive_reason_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts items to those with any of the specified archive reasons. Use "NOT_ARCHIVED" to filter for unarchived items. Use "ANY_ARCHIVED" to filter for archived items regardless of reason. Use "ANY_ARCHIVED_OR_NOT_ARCHIVED" to return items for both archived and unarchived. Comma-separated list.
+
+        archived_any_of : typing.Optional[typing.Union[bool, typing.Sequence[bool]]]
+            If true, returns archived items. If false, returns unarchived items. If both true and false, returns archived and unarchived items. Comma-separated list.
+
+        authors_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those whose author matches any of the specified user or author IDs. Comma-separated list.
+
+        created_at_gt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created after the specified time. e.g. > 2017-04-30.
+
+        created_at_gte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created at or after the specified time. e.g. >= 2017-04-30.
+
+        created_at_lt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created before the specified time. e.g. < 2017-04-30.
+
+        created_at_lte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created at or before the specified time. e.g. <= 2017-04-30.
+
+        creator_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those created by any of the specified user IDs. Comma-separated list.
+
+        entity_registry_ids_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those that match any of the specified entity registry IDs. Comma-separated list.
+
+        fieldset_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those whose schema implements any of the specified fieldset API IDs (custom schema interfaces). Comma-separated list.
+
+        folder_eq : typing.Optional[str]
+            ID of a folder. Restricts results to its direct children.
+
+        id_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those matching any of the specified IDs. Comma-separated list.
+
+        mentioned_in_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to items mentioned in entries matching any of the specified entry IDs. Comma-separated list.
+
+        modified_at_gt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those modified after the specified time. e.g. > 2017-04-30.
+
+        modified_at_gte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those modified at or after the specified time. e.g. >= 2017-04-30.
+
+        modified_at_lt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those modified before the specified time. e.g. < 2017-04-30.
+
+        modified_at_lte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those modified at or before the specified time. e.g. <= 2017-04-30.
+
+        name_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those that match any of the specified names. Case insensitive. Warning - this filter can be non-performant due to case insensitivity. Ensure only one name filter is used at a time. Comma-separated list.
+
+        name_any_of_case_sensitive : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those that match any of the specified names. Case sensitive. Ensure only one name filter is used at a time. Comma-separated list.
+
+        next_token : typing.Optional[str]
+            Token for pagination
+
+        omit : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Comma-separated list of top-level fields to omit from each returned item. Cannot overlap with returning.
+
+        page_size : typing.Optional[int]
+            Number of results to return. Defaults to 50, maximum of 100.
+
+        project_eq : typing.Optional[str]
+            ID of a project. Restricts results to those in the project.
+
+        registry_eq : typing.Optional[str]
+            ID of a registry. Restricts results to those registered in this registry. Specifying "null" returns unregistered items.
+
+        returning : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Comma-separated list of top-level fields to include in each returned item. Cannot overlap with omit.
+
+        schema_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those that match any of the specified schema IDs. Use only one `schema` filter arg at a time. Comma-separated list.
+
+        schema_eq : typing.Optional[str]
+            Single schema ID. Restricts results to those that match the specified schema exactly. Use only one `schema` filter arg at a time.
+
+        system_category_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those whose schema implements any of the specified system category API IDs (non-exclusive static schema interfaces). Comma-separated list.
+
+        sort : typing.Optional[ListProteinRequestSort]
+            Method by which to order results. Valid sorts are: createdAt (created time, oldest first) and modifiedAt (modified time, oldest first). Use :asc or :desc to specify ascending or descending order. Default is modifiedAt:desc.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncPager[Protein, ProteinPaginatedList]
+            OK
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import AsyncBenchling
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            response = await client.protein.list()
+            async for item in response:
+                yield item
+
+            # alternatively, you can paginate page-by-page
+            async for page in response.iter_pages():
+                yield page
+
+
+        asyncio.run(main())
+        """
+        return await self._raw_client.list(
+            archive_reason_any_of=archive_reason_any_of,
+            archived_any_of=archived_any_of,
+            authors_any_of=authors_any_of,
+            created_at_gt=created_at_gt,
+            created_at_gte=created_at_gte,
+            created_at_lt=created_at_lt,
+            created_at_lte=created_at_lte,
+            creator_any_of=creator_any_of,
+            entity_registry_ids_any_of=entity_registry_ids_any_of,
+            fieldset_any_of=fieldset_any_of,
+            folder_eq=folder_eq,
+            id_any_of=id_any_of,
+            mentioned_in_any_of=mentioned_in_any_of,
+            modified_at_gt=modified_at_gt,
+            modified_at_gte=modified_at_gte,
+            modified_at_lt=modified_at_lt,
+            modified_at_lte=modified_at_lte,
+            name_any_of=name_any_of,
+            name_any_of_case_sensitive=name_any_of_case_sensitive,
+            next_token=next_token,
+            omit=omit,
+            page_size=page_size,
+            project_eq=project_eq,
+            registry_eq=registry_eq,
+            returning=returning,
+            schema_any_of=schema_any_of,
+            schema_eq=schema_eq,
+            system_category_any_of=system_category_any_of,
+            sort=sort,
+            request_options=request_options,
+        )
+
+    async def get(
+        self,
+        protein_id: str,
+        *,
+        returning: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        omit: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Protein:
+        """
+        Get a single Protein by ID.
+
+        Parameters
+        ----------
+        protein_id : str
+            ID of the Protein.
+
+        returning : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Comma-separated list of top-level fields to include in each returned item. Cannot overlap with omit.
+
+        omit : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Comma-separated list of top-level fields to omit from each returned item. Cannot overlap with returning.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Protein
+            OK
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import AsyncBenchling
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            await client.protein.get(
+                protein_id="protein_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get(
+            protein_id, returning=returning, omit=omit, request_options=request_options
+        )
+        return _response.data
+
+    async def update(
+        self,
+        protein_id: str,
+        *,
+        aliases: typing.Optional[typing.Sequence[str]] = OMIT,
+        archive_reason: typing.Optional[str] = OMIT,
+        archived: typing.Optional[bool] = OMIT,
+        author_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        chains: typing.Optional[typing.Sequence[ProteinChainInput]] = OMIT,
+        custom_fields: typing.Optional[typing.Dict[str, FieldValueInput]] = OMIT,
+        domains: typing.Optional[typing.Sequence[ProteinDomainInput]] = OMIT,
+        entity_registry_id: typing.Optional[str] = OMIT,
+        folder_id: typing.Optional[str] = OMIT,
+        name: typing.Optional[str] = OMIT,
+        naming_strategy: typing.Optional[UpdateProteinInputNamingStrategy] = OMIT,
+        registry_id: typing.Optional[str] = OMIT,
+        schema_fields: typing.Optional[typing.Dict[str, FieldValueInput]] = OMIT,
+        schema_id: typing.Optional[str] = OMIT,
+        study_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Protein:
+        """
+        Update Protein.
+
+        Parameters
+        ----------
+        protein_id : str
+            ID of the Protein.
+
+        aliases : typing.Optional[typing.Sequence[str]]
+
+        archive_reason : typing.Optional[str]
+
+        archived : typing.Optional[bool]
+
+        author_ids : typing.Optional[typing.Sequence[str]]
+
+        chains : typing.Optional[typing.Sequence[ProteinChainInput]]
+            A chain input for each chain on the relevant format. Must be all provided if domains are provided.
+
+        custom_fields : typing.Optional[typing.Dict[str, FieldValueInput]]
+
+        domains : typing.Optional[typing.Sequence[ProteinDomainInput]]
+            A domain input for each domain on the relevant format. If any are provided, all must be provided.
+
+        entity_registry_id : typing.Optional[str]
+            Registry ID to assign to the entity. When registering, specifying this value sets the registry ID of the entity. When already registered, specifying this value updates the entity's registry ID. If set, naming_strategy must be unspecified.
+
+        folder_id : typing.Optional[str]
+
+        name : typing.Optional[str]
+            Name of the item.
+
+        naming_strategy : typing.Optional[UpdateProteinInputNamingStrategy]
+            Strategy to use for labeling the item in the registry if registering. If one is specified, the entity_registry_id must be unspecified.
+
+        registry_id : typing.Optional[str]
+            A not null value means the entity should be registered. A null value means it should be unregistered. If not null, the value must match the registry of the item's schema.
+
+        schema_fields : typing.Optional[typing.Dict[str, FieldValueInput]]
+
+        schema_id : typing.Optional[str]
+
+        study_ids : typing.Optional[typing.Sequence[str]]
+            Study IDs to add the protein to.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Protein
+            OK
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import AsyncBenchling
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            await client.protein.update(
+                protein_id="protein_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.update(
+            protein_id,
+            aliases=aliases,
+            archive_reason=archive_reason,
+            archived=archived,
+            author_ids=author_ids,
+            chains=chains,
+            custom_fields=custom_fields,
+            domains=domains,
+            entity_registry_id=entity_registry_id,
+            folder_id=folder_id,
+            name=name,
+            naming_strategy=naming_strategy,
+            registry_id=registry_id,
+            schema_fields=schema_fields,
+            schema_id=schema_id,
+            study_ids=study_ids,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def list_authors(
+        self, protein_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> PrincipalUnpaginatedList:
+        """
+        List Principal items.
+
+        Parameters
+        ----------
+        protein_id : str
+            ID of the Protein.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        PrincipalUnpaginatedList
+            OK
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import AsyncBenchling
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            await client.protein.list_authors(
+                protein_id="protein_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.list_authors(protein_id, request_options=request_options)
+        return _response.data
+
+    async def list_full_history(
+        self,
+        protein_id: str,
+        *,
+        created_at_gt: typing.Optional[str] = None,
+        created_at_gte: typing.Optional[str] = None,
+        created_at_lt: typing.Optional[str] = None,
+        created_at_lte: typing.Optional[str] = None,
+        id_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        next_token: typing.Optional[str] = None,
+        page_size: typing.Optional[int] = None,
+        protein_history_eq: typing.Optional[str] = None,
+        sort: typing.Optional[ListFullHistoryProteinRequestSort] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncPager[ProteinVersion, ProteinVersionPaginatedList]:
+        """
+        List ProteinVersion items.
+
+        Parameters
+        ----------
+        protein_id : str
+            ID of the Protein.
+
+        created_at_gt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created after the specified time. e.g. > 2017-04-30.
+
+        created_at_gte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created at or after the specified time. e.g. >= 2017-04-30.
+
+        created_at_lt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created before the specified time. e.g. < 2017-04-30.
+
+        created_at_lte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created at or before the specified time. e.g. <= 2017-04-30.
+
+        id_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those matching any of the specified IDs. Comma-separated list.
+
+        next_token : typing.Optional[str]
+            Token for pagination
+
+        page_size : typing.Optional[int]
+            Number of results to return. Defaults to 50, maximum of 100.
+
+        protein_history_eq : typing.Optional[str]
+            ID of the Protein that owns the version.
+
+        sort : typing.Optional[ListFullHistoryProteinRequestSort]
+            Method by which to order results. Valid sorts are: createdAt (created time, oldest first). Use :asc or :desc to specify ascending or descending order. Default is createdAt:asc.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncPager[ProteinVersion, ProteinVersionPaginatedList]
+            OK
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import AsyncBenchling
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            response = await client.protein.list_full_history(
+                protein_id="protein_id",
+            )
+            async for item in response:
+                yield item
+
+            # alternatively, you can paginate page-by-page
+            async for page in response.iter_pages():
+                yield page
+
+
+        asyncio.run(main())
+        """
+        return await self._raw_client.list_full_history(
+            protein_id,
+            created_at_gt=created_at_gt,
+            created_at_gte=created_at_gte,
+            created_at_lt=created_at_lt,
+            created_at_lte=created_at_lte,
+            id_any_of=id_any_of,
+            next_token=next_token,
+            page_size=page_size,
+            protein_history_eq=protein_history_eq,
+            sort=sort,
+            request_options=request_options,
+        )
+
+    async def list_history(
+        self,
+        protein_id: str,
+        *,
+        created_at_gt: typing.Optional[str] = None,
+        created_at_gte: typing.Optional[str] = None,
+        created_at_lt: typing.Optional[str] = None,
+        created_at_lte: typing.Optional[str] = None,
+        id_any_of: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        next_token: typing.Optional[str] = None,
+        page_size: typing.Optional[int] = None,
+        protein_full_history_eq: typing.Optional[str] = None,
+        sort: typing.Optional[ListHistoryProteinRequestSort] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncPager[ProteinVersion, ProteinVersionPaginatedList]:
+        """
+        List ProteinVersion items.
+
+        Parameters
+        ----------
+        protein_id : str
+            ID of the Protein.
+
+        created_at_gt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created after the specified time. e.g. > 2017-04-30.
+
+        created_at_gte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created at or after the specified time. e.g. >= 2017-04-30.
+
+        created_at_lt : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created before the specified time. e.g. < 2017-04-30.
+
+        created_at_lte : typing.Optional[str]
+            Datetime, in RFC 3339 format. Time zone defaults to UTC. Restricts results to those created at or before the specified time. e.g. <= 2017-04-30.
+
+        id_any_of : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Restricts results to those matching any of the specified IDs. Comma-separated list.
+
+        next_token : typing.Optional[str]
+            Token for pagination
+
+        page_size : typing.Optional[int]
+            Number of results to return. Defaults to 50, maximum of 100.
+
+        protein_full_history_eq : typing.Optional[str]
+            ID of the Protein that owns the version.
+
+        sort : typing.Optional[ListHistoryProteinRequestSort]
+            Method by which to order results. Valid sorts are: createdAt (created time, oldest first). Use :asc or :desc to specify ascending or descending order. Default is createdAt:asc.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncPager[ProteinVersion, ProteinVersionPaginatedList]
+            OK
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import AsyncBenchling
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            response = await client.protein.list_history(
+                protein_id="protein_id",
+            )
+            async for item in response:
+                yield item
+
+            # alternatively, you can paginate page-by-page
+            async for page in response.iter_pages():
+                yield page
+
+
+        asyncio.run(main())
+        """
+        return await self._raw_client.list_history(
+            protein_id,
+            created_at_gt=created_at_gt,
+            created_at_gte=created_at_gte,
+            created_at_lt=created_at_lt,
+            created_at_lte=created_at_lte,
+            id_any_of=id_any_of,
+            next_token=next_token,
+            page_size=page_size,
+            protein_full_history_eq=protein_full_history_eq,
+            sort=sort,
+            request_options=request_options,
+        )
+
+    async def batch_create(
+        self, *, items: typing.Sequence[CreateProteinInput], request_options: typing.Optional[RequestOptions] = None
+    ) -> BatchCreateProteinResponse:
+        """
+        Batch create Protein synchronously in one transaction. Maximum 25 items per request.
+
+        Parameters
+        ----------
+        items : typing.Sequence[CreateProteinInput]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        BatchCreateProteinResponse
+            Created
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import (
+            AsyncBenchling,
+            CreateProteinInput,
+            ProteinChainInput,
+            ProteinDomainInput,
+        )
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            await client.protein.batch_create(
+                items=[
+                    CreateProteinInput(
+                        chains=[
+                            ProteinChainInput(
+                                aa_sequence_id="aaSequenceId",
+                                label="label",
+                            )
+                        ],
+                        domains=[
+                            ProteinDomainInput(
+                                aa_sequence_id="aaSequenceId",
+                                label="label",
+                            )
+                        ],
+                        folder_id="folderId",
+                        name="name",
+                        schema_id="schemaId",
+                    )
+                ],
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.batch_create(items=items, request_options=request_options)
+        return _response.data
+
+    async def batch_update(
+        self,
+        *,
+        items: typing.Sequence[UpdateProteinInputWithPathParams],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> BatchUpdateProteinResponse:
+        """
+        Batch update Protein synchronously in one transaction. Maximum 25 items per request.
+
+        Parameters
+        ----------
+        items : typing.Sequence[UpdateProteinInputWithPathParams]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        BatchUpdateProteinResponse
+            OK
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import AsyncBenchling, UpdateProteinInputWithPathParams
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            await client.protein.batch_update(
+                items=[
+                    UpdateProteinInputWithPathParams(
+                        id="id",
+                    )
+                ],
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.batch_update(items=items, request_options=request_options)
+        return _response.data
+
+    async def bulk_create(
+        self, *, file_id: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncTaskLink:
+        """
+        Bulk create Protein.
+
+        Parameters
+        ----------
+        file_id : str
+            The API ID of the scratch file (`scrfile_XXXXXXXX`) containing the items to import. The referenced file must be a scratch file whose upload has completed successfully.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncTaskLink
+            Task started
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import AsyncBenchling
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            await client.protein.bulk_create(
+                file_id="scrfile_jdf8BV24kLmN",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.bulk_create(file_id=file_id, request_options=request_options)
+        return _response.data
+
+    async def bulk_update(
+        self, *, file_id: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncTaskLink:
+        """
+        Bulk update Protein.
+
+        Parameters
+        ----------
+        file_id : str
+            The API ID of the scratch file (`scrfile_XXXXXXXX`) containing the items to import. The referenced file must be a scratch file whose upload has completed successfully.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncTaskLink
+            Task started
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import AsyncBenchling
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            await client.protein.bulk_update(
+                file_id="scrfile_jdf8BV24kLmN",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.bulk_update(file_id=file_id, request_options=request_options)
+        return _response.data
+
+    async def bulk_create_and_register_proteins_and_components(
+        self,
+        *,
+        folder_id: str,
+        new_component_config: BulkCreateAndRegisterProteinsAndComponentsProteinRequestNewComponentConfig,
+        protein_create_inputs: typing.Sequence[
+            BulkCreateAndRegisterProteinsAndComponentsProteinRequestProteinCreateInputsItem
+        ],
+        protein_schema_id: str,
+        entry_id: typing.Optional[str] = OMIT,
+        germline_configs: typing.Optional[
+            typing.Sequence[BulkCreateAndRegisterProteinsAndComponentsProteinRequestGermlineConfigsItem]
+        ] = OMIT,
+        translation_parameters: typing.Optional[
+            BulkCreateAndRegisterProteinsAndComponentsProteinRequestTranslationParameters
+        ] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> BulkCreateAndRegisterProteinsAndComponentsProteinResponse:
+        """
+        Create and register proteins and their component parts (domains, chains, and variable pairs)
+
+        Parameters
+        ----------
+        folder_id : str
+            The ID of the folder in which the new entities should be created.
+
+        new_component_config : BulkCreateAndRegisterProteinsAndComponentsProteinRequestNewComponentConfig
+            Schema IDs for new component entities created during this request.
+            Applies to all rows in the request.
+
+        protein_create_inputs : typing.Sequence[BulkCreateAndRegisterProteinsAndComponentsProteinRequestProteinCreateInputsItem]
+
+        protein_schema_id : str
+            The schema ID for the protein entity type.
+
+        entry_id : typing.Optional[str]
+            The ID of the notebook entry into which the creation results will be embedded upon completion.
+            If omitted, no results are written to a notebook entry.
+
+        germline_configs : typing.Optional[typing.Sequence[BulkCreateAndRegisterProteinsAndComponentsProteinRequestGermlineConfigsItem]]
+            A list of germline configs indicating the germline with which to annotate each domain key.
+            This applies to all rows in the request.
+
+        translation_parameters : typing.Optional[BulkCreateAndRegisterProteinsAndComponentsProteinRequestTranslationParameters]
+            The translation parameters to use when creating AA sequences.
+            Required if the request contains DNA sequences.
+            May be omitted if the request contains only AA sequences.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        BulkCreateAndRegisterProteinsAndComponentsProteinResponse
+            Job status details
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import AsyncBenchling
+        from benchling_v3_sdk.protein import (
+            BulkCreateAndRegisterProteinsAndComponentsProteinRequestNewComponentConfig,
+        )
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            await client.protein.bulk_create_and_register_proteins_and_components(
+                folder_id="lib_lKsxK6",
+                new_component_config=BulkCreateAndRegisterProteinsAndComponentsProteinRequestNewComponentConfig(
+                    aa_pair_schema_id="ts_aapair012",
+                ),
+                protein_create_inputs=[],
+                protein_schema_id="ts_XEUrLw",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.bulk_create_and_register_proteins_and_components(
+            folder_id=folder_id,
+            new_component_config=new_component_config,
+            protein_create_inputs=protein_create_inputs,
+            protein_schema_id=protein_schema_id,
+            entry_id=entry_id,
+            germline_configs=germline_configs,
+            translation_parameters=translation_parameters,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def get_task_for_bulk_create_and_register_proteins_and_components(
+        self, task_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> GetTaskForBulkCreateAndRegisterProteinsAndComponentsProteinResponse:
+        """
+        Get the current status of a bulk-create-and-register-proteins-and-components task.
+        When a job reaches a `COMPLETED` status, you can call the
+        `GET /tasks/bulk-create-and-register-proteins-and-components/{task_id}/results`
+        endpoint to fetch task results and errors.
+
+        Task IDs for this endpoint remain queryable for 14 days after the
+        job is created.
+        After that TTL expires, this endpoint returns 404. Retrieve any status
+        and results you need before the task ID expires.
+
+        Parameters
+        ----------
+        task_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetTaskForBulkCreateAndRegisterProteinsAndComponentsProteinResponse
+            Job status details
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import AsyncBenchling
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            await client.protein.get_task_for_bulk_create_and_register_proteins_and_components(
+                task_id="task_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_task_for_bulk_create_and_register_proteins_and_components(
+            task_id, request_options=request_options
+        )
+        return _response.data
+
+    async def get_results_for_bulk_create_and_register_proteins_and_components(
+        self, task_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> GetResultsForBulkCreateAndRegisterProteinsAndComponentsProteinResponse:
+        """
+        Get the results of a completed bulk-create-and-register-proteins-and-components task.
+
+        This endpoint returns an identifier for the output dataset, plus an optional
+        pre-signed URL to download the errors file if any inputs failed validation.
+
+        Task IDs for this endpoint remain queryable for 14 days after the
+        job is created.
+        After that TTL expires, this endpoint returns 404. Retrieve the dataset
+        ID and any errors file URL you need before the task ID expires.
+
+        **Partial Success**: A job can complete with both successful and failed inputs. Always check
+        `errorsFileUrl` even when `datasetId` is present, since some inputs may have been rejected
+        while others were created successfully.
+
+        Behavior:
+        - Returns 400 unless the task has a COMPLETED status. While a task is running
+          you can poll the
+          `GET /tasks/bulk-create-and-register-proteins-and-components/{task_id}`
+          endpoint first and only call this endpoint once
+          `status == "COMPLETED"`. If the status becomes FAILED, this endpoint
+          will always return 400.
+        - If the task is in a COMPLETED status, returns parameters you can
+          use to fetch output and error data.  See the descriptions of the output
+          parameters for more detail.
+
+        Parameters
+        ----------
+        task_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetResultsForBulkCreateAndRegisterProteinsAndComponentsProteinResponse
+            Task results
+
+        Examples
+        --------
+        import asyncio
+
+        from benchling_v3_sdk import AsyncBenchling
+
+        client = AsyncBenchling(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            await client.protein.get_results_for_bulk_create_and_register_proteins_and_components(
+                task_id="cprotjob:ana_fhlbqd",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_results_for_bulk_create_and_register_proteins_and_components(
+            task_id, request_options=request_options
+        )
+        return _response.data