ncbi-datasets-pyclient 18.4.0__py3-none-any.whl → 18.13.0__py3-none-any.whl

ncbi/datasets/openapi/api/taxonomy_api.py

@@ -3,10 +3,9 @@
 """
     NCBI Datasets API
 
-    ### NCBI Datasets is a resource that lets you easily gather data from NCBI. The Datasets version 2 API is still in alpha, and we're updating it often to add new functionality, iron out bugs and enhance usability. For some larger downloads, you may want to download a [dehydrated zip archive](https://www.ncbi.nlm.nih.gov/datasets/docs/v2/how-tos/genomes/large-download/), and retrieve the individual data files at a later time. 
+    ### NCBI Datasets is a resource that lets you easily gather data from NCBI. The NCBI Datasets version 2 API is updated often to add new features, fix bugs, and enhance usability. 
 
     The version of the OpenAPI document: v2
-    Contact: help@ncbi.nlm.nih.gov
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
@@ -379,9 +378,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> bytearray:
-        """Get a taxonomy data package by tax_id
+        """Get a taxonomy data package by Taxonomy ID
 
-        Download a taxonomy report and names data package.
+        Download a taxonomy data package, including taxonomy and names reports, as a compressed zip archive.
 
         :param v2_taxonomy_dataset_request: (required)
         :type v2_taxonomy_dataset_request: V2TaxonomyDatasetRequest
@@ -450,9 +449,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> ApiResponse[bytearray]:
-        """Get a taxonomy data package by tax_id
+        """Get a taxonomy data package by Taxonomy ID
 
-        Download a taxonomy report and names data package.
+        Download a taxonomy data package, including taxonomy and names reports, as a compressed zip archive.
 
         :param v2_taxonomy_dataset_request: (required)
         :type v2_taxonomy_dataset_request: V2TaxonomyDatasetRequest
@@ -521,9 +520,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Get a taxonomy data package by tax_id
+        """Get a taxonomy data package by Taxonomy ID
 
-        Download a taxonomy report and names data package.
+        Download a taxonomy data package, including taxonomy and names reports, as a compressed zip archive.
 
         :param v2_taxonomy_dataset_request: (required)
         :type v2_taxonomy_dataset_request: V2TaxonomyDatasetRequest
@@ -656,7 +655,7 @@ class TaxonomyApi:
     @validate_call
     def tax_name_query(
         self,
-        taxon_query: Annotated[StrictStr, Field(description="NCBI Taxonomy ID or name (common or scientific) at any taxonomic rank")],
+        taxon_query: Annotated[StrictStr, Field(description="Taxid or name (common or scientific) at any taxonomic rank")],
         tax_rank_filter: Annotated[Optional[V2OrganismQueryRequestTaxRankFilter], Field(description="Set the scope of searched tax ranks when filtering by gene or genome.  Not used for 'all'")] = None,
         taxon_resource_filter: Annotated[Optional[V2OrganismQueryRequestTaxonResourceFilter], Field(description="Limit results to those with gene or genome counts (no filter by default)")] = None,
         exact_match: Annotated[Optional[StrictBool], Field(description="If true, only return results that exactly match the provided name or tax-id")] = None,
@@ -677,7 +676,7 @@ class TaxonomyApi:
 
         This endpoint retrieves a list of taxonomy names and IDs given a possibly partial taxonomic name of any rank.
 
-        :param taxon_query: NCBI Taxonomy ID or name (common or scientific) at any taxonomic rank (required)
+        :param taxon_query: Taxid or name (common or scientific) at any taxonomic rank (required)
         :type taxon_query: str
         :param tax_rank_filter: Set the scope of searched tax ranks when filtering by gene or genome.  Not used for 'all'
         :type tax_rank_filter: V2OrganismQueryRequestTaxRankFilter
@@ -735,7 +734,7 @@ class TaxonomyApi:
     @validate_call
     def tax_name_query_with_http_info(
         self,
-        taxon_query: Annotated[StrictStr, Field(description="NCBI Taxonomy ID or name (common or scientific) at any taxonomic rank")],
+        taxon_query: Annotated[StrictStr, Field(description="Taxid or name (common or scientific) at any taxonomic rank")],
         tax_rank_filter: Annotated[Optional[V2OrganismQueryRequestTaxRankFilter], Field(description="Set the scope of searched tax ranks when filtering by gene or genome.  Not used for 'all'")] = None,
         taxon_resource_filter: Annotated[Optional[V2OrganismQueryRequestTaxonResourceFilter], Field(description="Limit results to those with gene or genome counts (no filter by default)")] = None,
         exact_match: Annotated[Optional[StrictBool], Field(description="If true, only return results that exactly match the provided name or tax-id")] = None,
@@ -756,7 +755,7 @@ class TaxonomyApi:
 
         This endpoint retrieves a list of taxonomy names and IDs given a possibly partial taxonomic name of any rank.
 
-        :param taxon_query: NCBI Taxonomy ID or name (common or scientific) at any taxonomic rank (required)
+        :param taxon_query: Taxid or name (common or scientific) at any taxonomic rank (required)
         :type taxon_query: str
         :param tax_rank_filter: Set the scope of searched tax ranks when filtering by gene or genome.  Not used for 'all'
         :type tax_rank_filter: V2OrganismQueryRequestTaxRankFilter
@@ -814,7 +813,7 @@ class TaxonomyApi:
     @validate_call
     def tax_name_query_without_preload_content(
         self,
-        taxon_query: Annotated[StrictStr, Field(description="NCBI Taxonomy ID or name (common or scientific) at any taxonomic rank")],
+        taxon_query: Annotated[StrictStr, Field(description="Taxid or name (common or scientific) at any taxonomic rank")],
         tax_rank_filter: Annotated[Optional[V2OrganismQueryRequestTaxRankFilter], Field(description="Set the scope of searched tax ranks when filtering by gene or genome.  Not used for 'all'")] = None,
         taxon_resource_filter: Annotated[Optional[V2OrganismQueryRequestTaxonResourceFilter], Field(description="Limit results to those with gene or genome counts (no filter by default)")] = None,
         exact_match: Annotated[Optional[StrictBool], Field(description="If true, only return results that exactly match the provided name or tax-id")] = None,
@@ -835,7 +834,7 @@ class TaxonomyApi:
 
         This endpoint retrieves a list of taxonomy names and IDs given a possibly partial taxonomic name of any rank.
 
-        :param taxon_query: NCBI Taxonomy ID or name (common or scientific) at any taxonomic rank (required)
+        :param taxon_query: Taxid or name (common or scientific) at any taxonomic rank (required)
         :type taxon_query: str
         :param tax_rank_filter: Set the scope of searched tax ranks when filtering by gene or genome.  Not used for 'all'
         :type tax_rank_filter: V2OrganismQueryRequestTaxRankFilter
@@ -1247,8 +1246,8 @@ class TaxonomyApi:
         taxons: List[StrictStr],
         returned_content: Annotated[Optional[V2TaxonomyMetadataRequestContentType], Field(description="Return either tax-ids alone, or entire taxononmy-metadata records")] = None,
         page_size: Annotated[Optional[StrictInt], Field(description="The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.")] = None,
-        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Whether this request for tabular data should include the header row")] = None,
-        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.")] = None,
+        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Specify when to include the table header when requesting a tabular report.")] = None,
+        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
         table_format: Optional[V2TaxonomyMetadataRequestTableFormat] = None,
         children: Annotated[Optional[StrictBool], Field(description="Flag for tax explosion.")] = None,
         ranks: Annotated[Optional[List[V2reportsRankType]], Field(description="Only include taxons of the provided ranks. If empty, return all ranks.")] = None,
@@ -1275,9 +1274,9 @@ class TaxonomyApi:
         :type returned_content: V2TaxonomyMetadataRequestContentType
         :param page_size: The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
         :type page_size: int
-        :param include_tabular_header: Whether this request for tabular data should include the header row
+        :param include_tabular_header: Specify when to include the table header when requesting a tabular report.
         :type include_tabular_header: V2IncludeTabularHeader
-        :param page_token: A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.
+        :param page_token: A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
         :type page_token: str
         :param table_format:
         :type table_format: V2TaxonomyMetadataRequestTableFormat
@@ -1342,8 +1341,8 @@ class TaxonomyApi:
         taxons: List[StrictStr],
         returned_content: Annotated[Optional[V2TaxonomyMetadataRequestContentType], Field(description="Return either tax-ids alone, or entire taxononmy-metadata records")] = None,
         page_size: Annotated[Optional[StrictInt], Field(description="The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.")] = None,
-        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Whether this request for tabular data should include the header row")] = None,
-        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.")] = None,
+        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Specify when to include the table header when requesting a tabular report.")] = None,
+        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
         table_format: Optional[V2TaxonomyMetadataRequestTableFormat] = None,
         children: Annotated[Optional[StrictBool], Field(description="Flag for tax explosion.")] = None,
         ranks: Annotated[Optional[List[V2reportsRankType]], Field(description="Only include taxons of the provided ranks. If empty, return all ranks.")] = None,
@@ -1370,9 +1369,9 @@ class TaxonomyApi:
         :type returned_content: V2TaxonomyMetadataRequestContentType
         :param page_size: The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
         :type page_size: int
-        :param include_tabular_header: Whether this request for tabular data should include the header row
+        :param include_tabular_header: Specify when to include the table header when requesting a tabular report.
         :type include_tabular_header: V2IncludeTabularHeader
-        :param page_token: A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.
+        :param page_token: A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
         :type page_token: str
         :param table_format:
         :type table_format: V2TaxonomyMetadataRequestTableFormat
@@ -1437,8 +1436,8 @@ class TaxonomyApi:
         taxons: List[StrictStr],
         returned_content: Annotated[Optional[V2TaxonomyMetadataRequestContentType], Field(description="Return either tax-ids alone, or entire taxononmy-metadata records")] = None,
         page_size: Annotated[Optional[StrictInt], Field(description="The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.")] = None,
-        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Whether this request for tabular data should include the header row")] = None,
-        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.")] = None,
+        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Specify when to include the table header when requesting a tabular report.")] = None,
+        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
         table_format: Optional[V2TaxonomyMetadataRequestTableFormat] = None,
         children: Annotated[Optional[StrictBool], Field(description="Flag for tax explosion.")] = None,
         ranks: Annotated[Optional[List[V2reportsRankType]], Field(description="Only include taxons of the provided ranks. If empty, return all ranks.")] = None,
@@ -1465,9 +1464,9 @@ class TaxonomyApi:
         :type returned_content: V2TaxonomyMetadataRequestContentType
         :param page_size: The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
         :type page_size: int
-        :param include_tabular_header: Whether this request for tabular data should include the header row
+        :param include_tabular_header: Specify when to include the table header when requesting a tabular report.
         :type include_tabular_header: V2IncludeTabularHeader
-        :param page_token: A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.
+        :param page_token: A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
         :type page_token: str
         :param table_format:
         :type table_format: V2TaxonomyMetadataRequestTableFormat
@@ -1643,9 +1642,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> V2reportsTaxonomyDataReportPage:
-        """Use taxonomic identifiers to get taxonomic names data report by post
+        """Get a taxonomy data report by taxon
 
-        Using NCBI Taxonomy IDs or names (common or scientific) at any rank, get metadata about a taxonomic node including taxonomic identifiers, lineage information, child nodes, and gene and genome counts in JSON format.
+        Get a taxonomy data report by taxon. By default, in paged JSON format, but also available in tabular (accept: text/tab-separated-values) or JSON Lines (accept: application/x-ndjson) formats.
 
         :param v2_taxonomy_metadata_request: (required)
         :type v2_taxonomy_metadata_request: V2TaxonomyMetadataRequest
@@ -1710,9 +1709,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> ApiResponse[V2reportsTaxonomyDataReportPage]:
-        """Use taxonomic identifiers to get taxonomic names data report by post
+        """Get a taxonomy data report by taxon
 
-        Using NCBI Taxonomy IDs or names (common or scientific) at any rank, get metadata about a taxonomic node including taxonomic identifiers, lineage information, child nodes, and gene and genome counts in JSON format.
+        Get a taxonomy data report by taxon. By default, in paged JSON format, but also available in tabular (accept: text/tab-separated-values) or JSON Lines (accept: application/x-ndjson) formats.
 
         :param v2_taxonomy_metadata_request: (required)
         :type v2_taxonomy_metadata_request: V2TaxonomyMetadataRequest
@@ -1777,9 +1776,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Use taxonomic identifiers to get taxonomic names data report by post
+        """Get a taxonomy data report by taxon
 
-        Using NCBI Taxonomy IDs or names (common or scientific) at any rank, get metadata about a taxonomic node including taxonomic identifiers, lineage information, child nodes, and gene and genome counts in JSON format.
+        Get a taxonomy data report by taxon. By default, in paged JSON format, but also available in tabular (accept: text/tab-separated-values) or JSON Lines (accept: application/x-ndjson) formats.
 
         :param v2_taxonomy_metadata_request: (required)
         :type v2_taxonomy_metadata_request: V2TaxonomyMetadataRequest
@@ -1907,8 +1906,8 @@ class TaxonomyApi:
     def taxonomy_filtered_subtree(
         self,
         taxons: List[StrictStr],
-        specified_limit: Annotated[Optional[StrictBool], Field(description="Limit to specified species")] = None,
         rank_limits: Annotated[Optional[List[V2reportsRankType]], Field(description="Limit to the provided ranks.  If empty, accept any rank.")] = None,
+        include_incertae_sedis: Annotated[Optional[StrictBool], Field(description="Include nodes with ranks not in 'rank_limits' if their names meet criteria for incertae sedis (of unknown origin).")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1928,10 +1927,10 @@ class TaxonomyApi:
 
         :param taxons: (required)
         :type taxons: List[str]
-        :param specified_limit: Limit to specified species
-        :type specified_limit: bool
         :param rank_limits: Limit to the provided ranks.  If empty, accept any rank.
         :type rank_limits: List[V2reportsRankType]
+        :param include_incertae_sedis: Include nodes with ranks not in 'rank_limits' if their names meet criteria for incertae sedis (of unknown origin).
+        :type include_incertae_sedis: bool
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1956,8 +1955,8 @@ class TaxonomyApi:
 
         _param = self._taxonomy_filtered_subtree_serialize(
             taxons=taxons,
-            specified_limit=specified_limit,
             rank_limits=rank_limits,
+            include_incertae_sedis=include_incertae_sedis,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1982,8 +1981,8 @@ class TaxonomyApi:
     def taxonomy_filtered_subtree_with_http_info(
         self,
         taxons: List[StrictStr],
-        specified_limit: Annotated[Optional[StrictBool], Field(description="Limit to specified species")] = None,
         rank_limits: Annotated[Optional[List[V2reportsRankType]], Field(description="Limit to the provided ranks.  If empty, accept any rank.")] = None,
+        include_incertae_sedis: Annotated[Optional[StrictBool], Field(description="Include nodes with ranks not in 'rank_limits' if their names meet criteria for incertae sedis (of unknown origin).")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -2003,10 +2002,10 @@ class TaxonomyApi:
 
         :param taxons: (required)
         :type taxons: List[str]
-        :param specified_limit: Limit to specified species
-        :type specified_limit: bool
         :param rank_limits: Limit to the provided ranks.  If empty, accept any rank.
         :type rank_limits: List[V2reportsRankType]
+        :param include_incertae_sedis: Include nodes with ranks not in 'rank_limits' if their names meet criteria for incertae sedis (of unknown origin).
+        :type include_incertae_sedis: bool
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -2031,8 +2030,8 @@ class TaxonomyApi:
 
         _param = self._taxonomy_filtered_subtree_serialize(
             taxons=taxons,
-            specified_limit=specified_limit,
             rank_limits=rank_limits,
+            include_incertae_sedis=include_incertae_sedis,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -2057,8 +2056,8 @@ class TaxonomyApi:
     def taxonomy_filtered_subtree_without_preload_content(
         self,
         taxons: List[StrictStr],
-        specified_limit: Annotated[Optional[StrictBool], Field(description="Limit to specified species")] = None,
         rank_limits: Annotated[Optional[List[V2reportsRankType]], Field(description="Limit to the provided ranks.  If empty, accept any rank.")] = None,
+        include_incertae_sedis: Annotated[Optional[StrictBool], Field(description="Include nodes with ranks not in 'rank_limits' if their names meet criteria for incertae sedis (of unknown origin).")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -2078,10 +2077,10 @@ class TaxonomyApi:
 
         :param taxons: (required)
         :type taxons: List[str]
-        :param specified_limit: Limit to specified species
-        :type specified_limit: bool
         :param rank_limits: Limit to the provided ranks.  If empty, accept any rank.
         :type rank_limits: List[V2reportsRankType]
+        :param include_incertae_sedis: Include nodes with ranks not in 'rank_limits' if their names meet criteria for incertae sedis (of unknown origin).
+        :type include_incertae_sedis: bool
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -2106,8 +2105,8 @@ class TaxonomyApi:
 
         _param = self._taxonomy_filtered_subtree_serialize(
             taxons=taxons,
-            specified_limit=specified_limit,
             rank_limits=rank_limits,
+            include_incertae_sedis=include_incertae_sedis,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -2127,8 +2126,8 @@ class TaxonomyApi:
     def _taxonomy_filtered_subtree_serialize(
         self,
         taxons,
-        specified_limit,
         rank_limits,
+        include_incertae_sedis,
         _request_auth,
         _content_type,
         _headers,
@@ -2155,14 +2154,14 @@ class TaxonomyApi:
         if taxons is not None:
             _path_params['taxons'] = taxons
         # process the query parameters
-        if specified_limit is not None:
-            
-            _query_params.append(('specified_limit', specified_limit))
-            
         if rank_limits is not None:
             
             _query_params.append(('rank_limits', rank_limits))
             
+        if include_incertae_sedis is not None:
+            
+            _query_params.append(('include_incertae_sedis', include_incertae_sedis))
+            
         # process the header parameters
         # process the form parameters
         # process the body parameter
@@ -2218,9 +2217,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> V2TaxonomyFilteredSubtreeResponse:
-        """Use taxonomic identifiers to get a filtered taxonomic subtree by post
+        """Get a filtered taxonomic subtree by taxon
 
-        Using NCBI Taxonomy IDs or names (common or scientific) at any rank, get a filtered taxonomic subtree that includes the full parent lineage and all immediate children from the selected taxonomic ranks in JSON format.
+        Get a filtered taxonomic subtree, including parent and child nodes, in JSON format.
 
         :param v2_taxonomy_filtered_subtree_request: (required)
         :type v2_taxonomy_filtered_subtree_request: V2TaxonomyFilteredSubtreeRequest
@@ -2285,9 +2284,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> ApiResponse[V2TaxonomyFilteredSubtreeResponse]:
-        """Use taxonomic identifiers to get a filtered taxonomic subtree by post
+        """Get a filtered taxonomic subtree by taxon
 
-        Using NCBI Taxonomy IDs or names (common or scientific) at any rank, get a filtered taxonomic subtree that includes the full parent lineage and all immediate children from the selected taxonomic ranks in JSON format.
+        Get a filtered taxonomic subtree, including parent and child nodes, in JSON format.
 
         :param v2_taxonomy_filtered_subtree_request: (required)
         :type v2_taxonomy_filtered_subtree_request: V2TaxonomyFilteredSubtreeRequest
@@ -2352,9 +2351,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Use taxonomic identifiers to get a filtered taxonomic subtree by post
+        """Get a filtered taxonomic subtree by taxon
 
-        Using NCBI Taxonomy IDs or names (common or scientific) at any rank, get a filtered taxonomic subtree that includes the full parent lineage and all immediate children from the selected taxonomic ranks in JSON format.
+        Get a filtered taxonomic subtree, including parent and child nodes, in JSON format.
 
         :param v2_taxonomy_filtered_subtree_request: (required)
         :type v2_taxonomy_filtered_subtree_request: V2TaxonomyFilteredSubtreeRequest
@@ -2494,9 +2493,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> bytearray:
-        """Retrieve image associated with a taxonomic identifier
+        """Get a taxonomy image by taxon
 
-        Using an NCBI Taxonomy ID or a name (common or scientific) at any rank, get the image associated with the taxon.
+        Get an image associated with the specified taxon. By default, in JPEG format, but also available in PNG (accept: image/png), TIFF (accept: accept: image/tiff), and SVG+XML (accept: image/svg+xml) formats.
 
         :param taxon: (required)
         :type taxon: str
@@ -2565,9 +2564,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> ApiResponse[bytearray]:
-        """Retrieve image associated with a taxonomic identifier
+        """Get a taxonomy image by taxon
 
-        Using an NCBI Taxonomy ID or a name (common or scientific) at any rank, get the image associated with the taxon.
+        Get an image associated with the specified taxon. By default, in JPEG format, but also available in PNG (accept: image/png), TIFF (accept: accept: image/tiff), and SVG+XML (accept: image/svg+xml) formats.
 
         :param taxon: (required)
         :type taxon: str
@@ -2636,9 +2635,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Retrieve image associated with a taxonomic identifier
+        """Get a taxonomy image by taxon
 
-        Using an NCBI Taxonomy ID or a name (common or scientific) at any rank, get the image associated with the taxon.
+        Get an image associated with the specified taxon. By default, in JPEG format, but also available in PNG (accept: image/png), TIFF (accept: accept: image/tiff), and SVG+XML (accept: image/svg+xml) formats.
 
         :param taxon: (required)
         :type taxon: str
@@ -3313,9 +3312,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> bytearray:
-        """Retrieve image associated with a taxonomic identifier by post
+        """Get a taxonomy image by taxon
 
-        Using an NCBI Taxonomy ID or a name (common or scientific) at any rank, get the image associated with the taxon.
+        Get an image associated with the specified taxon. By default, in JPEG format, but also available in PNG (accept: image/png), TIFF (accept: accept: image/tiff), and SVG+XML (accept: image/svg+xml) formats.
 
         :param v2_taxonomy_image_request: (required)
         :type v2_taxonomy_image_request: V2TaxonomyImageRequest
@@ -3380,9 +3379,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> ApiResponse[bytearray]:
-        """Retrieve image associated with a taxonomic identifier by post
+        """Get a taxonomy image by taxon
 
-        Using an NCBI Taxonomy ID or a name (common or scientific) at any rank, get the image associated with the taxon.
+        Get an image associated with the specified taxon. By default, in JPEG format, but also available in PNG (accept: image/png), TIFF (accept: accept: image/tiff), and SVG+XML (accept: image/svg+xml) formats.
 
         :param v2_taxonomy_image_request: (required)
         :type v2_taxonomy_image_request: V2TaxonomyImageRequest
@@ -3447,9 +3446,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Retrieve image associated with a taxonomic identifier by post
+        """Get a taxonomy image by taxon
 
-        Using an NCBI Taxonomy ID or a name (common or scientific) at any rank, get the image associated with the taxon.
+        Get an image associated with the specified taxon. By default, in JPEG format, but also available in PNG (accept: image/png), TIFF (accept: accept: image/tiff), and SVG+XML (accept: image/svg+xml) formats.
 
         :param v2_taxonomy_image_request: (required)
         :type v2_taxonomy_image_request: V2TaxonomyImageRequest
@@ -4117,8 +4116,8 @@ class TaxonomyApi:
         taxons: List[StrictStr],
         returned_content: Annotated[Optional[V2TaxonomyMetadataRequestContentType], Field(description="Return either tax-ids alone, or entire taxononmy-metadata records")] = None,
         page_size: Annotated[Optional[StrictInt], Field(description="The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.")] = None,
-        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Whether this request for tabular data should include the header row")] = None,
-        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.")] = None,
+        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Specify when to include the table header when requesting a tabular report.")] = None,
+        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
         table_format: Optional[V2TaxonomyMetadataRequestTableFormat] = None,
         children: Annotated[Optional[StrictBool], Field(description="Flag for tax explosion.")] = None,
         ranks: Annotated[Optional[List[V2reportsRankType]], Field(description="Only include taxons of the provided ranks. If empty, return all ranks.")] = None,
@@ -4135,7 +4134,7 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> V2TaxonomyMetadataResponse:
-        """Use taxonomic identifiers to get taxonomic metadata
+        """Use taxonomic identifiers to get taxonomic metadata (deprecated)
 
         Using NCBI Taxonomy IDs or names (common or scientific) at any rank, get metadata about a taxonomic node including taxonomic identifiers, lineage information, child nodes, and gene and genome counts in JSON format.
 
@@ -4145,9 +4144,9 @@ class TaxonomyApi:
         :type returned_content: V2TaxonomyMetadataRequestContentType
         :param page_size: The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
         :type page_size: int
-        :param include_tabular_header: Whether this request for tabular data should include the header row
+        :param include_tabular_header: Specify when to include the table header when requesting a tabular report.
         :type include_tabular_header: V2IncludeTabularHeader
-        :param page_token: A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.
+        :param page_token: A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
         :type page_token: str
         :param table_format:
         :type table_format: V2TaxonomyMetadataRequestTableFormat
@@ -4212,8 +4211,8 @@ class TaxonomyApi:
         taxons: List[StrictStr],
         returned_content: Annotated[Optional[V2TaxonomyMetadataRequestContentType], Field(description="Return either tax-ids alone, or entire taxononmy-metadata records")] = None,
         page_size: Annotated[Optional[StrictInt], Field(description="The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.")] = None,
-        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Whether this request for tabular data should include the header row")] = None,
-        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.")] = None,
+        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Specify when to include the table header when requesting a tabular report.")] = None,
+        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
         table_format: Optional[V2TaxonomyMetadataRequestTableFormat] = None,
         children: Annotated[Optional[StrictBool], Field(description="Flag for tax explosion.")] = None,
         ranks: Annotated[Optional[List[V2reportsRankType]], Field(description="Only include taxons of the provided ranks. If empty, return all ranks.")] = None,
@@ -4230,7 +4229,7 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> ApiResponse[V2TaxonomyMetadataResponse]:
-        """Use taxonomic identifiers to get taxonomic metadata
+        """Use taxonomic identifiers to get taxonomic metadata (deprecated)
 
         Using NCBI Taxonomy IDs or names (common or scientific) at any rank, get metadata about a taxonomic node including taxonomic identifiers, lineage information, child nodes, and gene and genome counts in JSON format.
 
@@ -4240,9 +4239,9 @@ class TaxonomyApi:
         :type returned_content: V2TaxonomyMetadataRequestContentType
         :param page_size: The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
         :type page_size: int
-        :param include_tabular_header: Whether this request for tabular data should include the header row
+        :param include_tabular_header: Specify when to include the table header when requesting a tabular report.
         :type include_tabular_header: V2IncludeTabularHeader
-        :param page_token: A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.
+        :param page_token: A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
         :type page_token: str
         :param table_format:
         :type table_format: V2TaxonomyMetadataRequestTableFormat
@@ -4307,8 +4306,8 @@ class TaxonomyApi:
         taxons: List[StrictStr],
         returned_content: Annotated[Optional[V2TaxonomyMetadataRequestContentType], Field(description="Return either tax-ids alone, or entire taxononmy-metadata records")] = None,
         page_size: Annotated[Optional[StrictInt], Field(description="The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.")] = None,
-        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Whether this request for tabular data should include the header row")] = None,
-        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.")] = None,
+        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Specify when to include the table header when requesting a tabular report.")] = None,
+        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
         table_format: Optional[V2TaxonomyMetadataRequestTableFormat] = None,
         children: Annotated[Optional[StrictBool], Field(description="Flag for tax explosion.")] = None,
         ranks: Annotated[Optional[List[V2reportsRankType]], Field(description="Only include taxons of the provided ranks. If empty, return all ranks.")] = None,
@@ -4325,7 +4324,7 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Use taxonomic identifiers to get taxonomic metadata
+        """Use taxonomic identifiers to get taxonomic metadata (deprecated)
 
         Using NCBI Taxonomy IDs or names (common or scientific) at any rank, get metadata about a taxonomic node including taxonomic identifiers, lineage information, child nodes, and gene and genome counts in JSON format.
 
@@ -4335,9 +4334,9 @@ class TaxonomyApi:
         :type returned_content: V2TaxonomyMetadataRequestContentType
         :param page_size: The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
         :type page_size: int
-        :param include_tabular_header: Whether this request for tabular data should include the header row
+        :param include_tabular_header: Specify when to include the table header when requesting a tabular report.
         :type include_tabular_header: V2IncludeTabularHeader
-        :param page_token: A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.
+        :param page_token: A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
         :type page_token: str
         :param table_format:
         :type table_format: V2TaxonomyMetadataRequestTableFormat
@@ -4511,9 +4510,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> V2TaxonomyMetadataResponse:
-        """Use taxonomic identifiers to get taxonomic metadata by post
+        """Get taxonomy metadata by taxon (deprecated)
 
-        Using NCBI Taxonomy IDs or names (common or scientific) at any rank, get metadata about a taxonomic node including taxonomic identifiers, lineage information, child nodes, and gene and genome counts in JSON format.
+        Get taxonomy metadata by taxon in JSON format.
 
         :param v2_taxonomy_metadata_request: (required)
         :type v2_taxonomy_metadata_request: V2TaxonomyMetadataRequest
@@ -4578,9 +4577,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> ApiResponse[V2TaxonomyMetadataResponse]:
-        """Use taxonomic identifiers to get taxonomic metadata by post
+        """Get taxonomy metadata by taxon (deprecated)
 
-        Using NCBI Taxonomy IDs or names (common or scientific) at any rank, get metadata about a taxonomic node including taxonomic identifiers, lineage information, child nodes, and gene and genome counts in JSON format.
+        Get taxonomy metadata by taxon in JSON format.
 
         :param v2_taxonomy_metadata_request: (required)
         :type v2_taxonomy_metadata_request: V2TaxonomyMetadataRequest
@@ -4645,9 +4644,9 @@ class TaxonomyApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Use taxonomic identifiers to get taxonomic metadata by post
+        """Get taxonomy metadata by taxon (deprecated)
 
-        Using NCBI Taxonomy IDs or names (common or scientific) at any rank, get metadata about a taxonomic node including taxonomic identifiers, lineage information, child nodes, and gene and genome counts in JSON format.
+        Get taxonomy metadata by taxon in JSON format.
 
         :param v2_taxonomy_metadata_request: (required)
         :type v2_taxonomy_metadata_request: V2TaxonomyMetadataRequest
@@ -4775,8 +4774,8 @@ class TaxonomyApi:
         taxons: List[StrictStr],
         returned_content: Annotated[Optional[V2TaxonomyMetadataRequestContentType], Field(description="Return either tax-ids alone, or entire taxononmy-metadata records")] = None,
         page_size: Annotated[Optional[StrictInt], Field(description="The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.")] = None,
-        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Whether this request for tabular data should include the header row")] = None,
-        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.")] = None,
+        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Specify when to include the table header when requesting a tabular report.")] = None,
+        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
         table_format: Optional[V2TaxonomyMetadataRequestTableFormat] = None,
         children: Annotated[Optional[StrictBool], Field(description="Flag for tax explosion.")] = None,
         ranks: Annotated[Optional[List[V2reportsRankType]], Field(description="Only include taxons of the provided ranks. If empty, return all ranks.")] = None,
@@ -4803,9 +4802,9 @@ class TaxonomyApi:
         :type returned_content: V2TaxonomyMetadataRequestContentType
         :param page_size: The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
         :type page_size: int
-        :param include_tabular_header: Whether this request for tabular data should include the header row
+        :param include_tabular_header: Specify when to include the table header when requesting a tabular report.
         :type include_tabular_header: V2IncludeTabularHeader
-        :param page_token: A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.
+        :param page_token: A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
         :type page_token: str
         :param table_format:
         :type table_format: V2TaxonomyMetadataRequestTableFormat
@@ -4870,8 +4869,8 @@ class TaxonomyApi:
         taxons: List[StrictStr],
         returned_content: Annotated[Optional[V2TaxonomyMetadataRequestContentType], Field(description="Return either tax-ids alone, or entire taxononmy-metadata records")] = None,
         page_size: Annotated[Optional[StrictInt], Field(description="The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.")] = None,
-        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Whether this request for tabular data should include the header row")] = None,
-        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.")] = None,
+        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Specify when to include the table header when requesting a tabular report.")] = None,
+        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
         table_format: Optional[V2TaxonomyMetadataRequestTableFormat] = None,
         children: Annotated[Optional[StrictBool], Field(description="Flag for tax explosion.")] = None,
         ranks: Annotated[Optional[List[V2reportsRankType]], Field(description="Only include taxons of the provided ranks. If empty, return all ranks.")] = None,
@@ -4898,9 +4897,9 @@ class TaxonomyApi:
         :type returned_content: V2TaxonomyMetadataRequestContentType
         :param page_size: The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
         :type page_size: int
-        :param include_tabular_header: Whether this request for tabular data should include the header row
+        :param include_tabular_header: Specify when to include the table header when requesting a tabular report.
         :type include_tabular_header: V2IncludeTabularHeader
-        :param page_token: A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.
+        :param page_token: A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
         :type page_token: str
         :param table_format:
         :type table_format: V2TaxonomyMetadataRequestTableFormat
@@ -4965,8 +4964,8 @@ class TaxonomyApi:
         taxons: List[StrictStr],
         returned_content: Annotated[Optional[V2TaxonomyMetadataRequestContentType], Field(description="Return either tax-ids alone, or entire taxononmy-metadata records")] = None,
         page_size: Annotated[Optional[StrictInt], Field(description="The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.")] = None,
-        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Whether this request for tabular data should include the header row")] = None,
-        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.")] = None,
+        include_tabular_header: Annotated[Optional[V2IncludeTabularHeader], Field(description="Specify when to include the table header when requesting a tabular report.")] = None,
+        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
         table_format: Optional[V2TaxonomyMetadataRequestTableFormat] = None,
         children: Annotated[Optional[StrictBool], Field(description="Flag for tax explosion.")] = None,
         ranks: Annotated[Optional[List[V2reportsRankType]], Field(description="Only include taxons of the provided ranks. If empty, return all ranks.")] = None,
@@ -4993,9 +4992,9 @@ class TaxonomyApi:
         :type returned_content: V2TaxonomyMetadataRequestContentType
         :param page_size: The maximum number of taxons to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
         :type page_size: int
-        :param include_tabular_header: Whether this request for tabular data should include the header row
+        :param include_tabular_header: Specify when to include the table header when requesting a tabular report.
         :type include_tabular_header: V2IncludeTabularHeader
-        :param page_token: A page token is returned from `GetTaxonomyDataReportFor` and `GetTaxonomyNamesDataReportFor` calls with more than `page_size` results. When `page_token` is empty, all results have been retrieved.
+        :param page_token: A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
         :type page_token: str
         :param table_format:
         :type table_format: V2TaxonomyMetadataRequestTableFormat
@@ -5435,7 +5434,7 @@ class TaxonomyApi:
         include_subtree: Annotated[Optional[StrictBool], Field(description="This field is deprecated because all requests include the subtree, so it has no effect")] = None,
         ranks: Annotated[Optional[List[V2reportsRankType]], Field(description="Only include taxons of the provided ranks. If empty, return all ranks.")] = None,
         page_size: Annotated[Optional[StrictInt], Field(description="The maximum number of taxids to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.")] = None,
-        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned from a `GetRelatedTaxids` call with more than `page_size` results. Use this token, along with the previous `TaxonomyRelatedIdRequest` parameters, to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
+        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -5463,7 +5462,7 @@ class TaxonomyApi:
         :type ranks: List[V2reportsRankType]
         :param page_size: The maximum number of taxids to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
         :type page_size: int
-        :param page_token: A page token is returned from a `GetRelatedTaxids` call with more than `page_size` results. Use this token, along with the previous `TaxonomyRelatedIdRequest` parameters, to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
+        :param page_token: A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
         :type page_token: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -5522,7 +5521,7 @@ class TaxonomyApi:
         include_subtree: Annotated[Optional[StrictBool], Field(description="This field is deprecated because all requests include the subtree, so it has no effect")] = None,
         ranks: Annotated[Optional[List[V2reportsRankType]], Field(description="Only include taxons of the provided ranks. If empty, return all ranks.")] = None,
         page_size: Annotated[Optional[StrictInt], Field(description="The maximum number of taxids to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.")] = None,
-        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned from a `GetRelatedTaxids` call with more than `page_size` results. Use this token, along with the previous `TaxonomyRelatedIdRequest` parameters, to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
+        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -5550,7 +5549,7 @@ class TaxonomyApi:
         :type ranks: List[V2reportsRankType]
         :param page_size: The maximum number of taxids to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
         :type page_size: int
-        :param page_token: A page token is returned from a `GetRelatedTaxids` call with more than `page_size` results. Use this token, along with the previous `TaxonomyRelatedIdRequest` parameters, to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
+        :param page_token: A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
         :type page_token: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -5609,7 +5608,7 @@ class TaxonomyApi:
         include_subtree: Annotated[Optional[StrictBool], Field(description="This field is deprecated because all requests include the subtree, so it has no effect")] = None,
         ranks: Annotated[Optional[List[V2reportsRankType]], Field(description="Only include taxons of the provided ranks. If empty, return all ranks.")] = None,
         page_size: Annotated[Optional[StrictInt], Field(description="The maximum number of taxids to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.")] = None,
-        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned from a `GetRelatedTaxids` call with more than `page_size` results. Use this token, along with the previous `TaxonomyRelatedIdRequest` parameters, to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
+        page_token: Annotated[Optional[StrictStr], Field(description="A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -5637,7 +5636,7 @@ class TaxonomyApi:
         :type ranks: List[V2reportsRankType]
         :param page_size: The maximum number of taxids to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
         :type page_size: int
-        :param page_token: A page token is returned from a `GetRelatedTaxids` call with more than `page_size` results. Use this token, along with the previous `TaxonomyRelatedIdRequest` parameters, to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
+        :param page_token: A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
         :type page_token: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request