Office365-REST-Python-Client 3.2.0__py3-none-any.whl → 3.3.1__py3-none-any.whl

office365/sharepoint/lists/list.py

@@ -1,8 +1,10 @@
 from __future__ import annotations
 
 import os
+from collections.abc import Mapping, Sequence
 from datetime import datetime
 from typing import IO, TYPE_CHECKING, Any, AnyStr, Callable, Dict, Optional, Union, cast
+from uuid import UUID
 
 from typing_extensions import Self
 
@@ -10,7 +12,9 @@ from office365.runtime.client_result import ClientResult
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.paths.service_operation import ServiceOperationPath
+from office365.runtime.queries.function import FunctionQuery
 from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.runtime.types.collections import GuidCollection
 from office365.runtime.types.odata_property import odata
 from office365.sharepoint.changes.collection import ChangeCollection
 from office365.sharepoint.changes.log_item_query import ChangeLogItemQuery
@@ -21,6 +25,7 @@ from office365.sharepoint.contenttypes.collection import ContentTypeCollection
 from office365.sharepoint.customactions.element_collection import (
     CustomActionElementCollection,
 )
+from office365.sharepoint.entity_collection import EntityCollection
 from office365.sharepoint.eventreceivers.definition_collection import (
     EventReceiverDefinitionCollection,
 )
@@ -40,7 +45,9 @@ from office365.sharepoint.forms.collection import FormCollection
 from office365.sharepoint.listitems.caml.guard import warn_if_unpaged
 from office365.sharepoint.listitems.caml.query import CamlQuery
 from office365.sharepoint.listitems.collection import ListItemCollection
-from office365.sharepoint.listitems.collection_position import ListItemCollectionPosition
+from office365.sharepoint.listitems.collection_position import (
+    ListItemCollectionPosition,
+)
 from office365.sharepoint.listitems.creation_information import (
     ListItemCreationInformation,
 )
@@ -49,6 +56,7 @@ from office365.sharepoint.listitems.creation_information_using_path import (
 )
 from office365.sharepoint.listitems.form_update_value import ListItemFormUpdateValue
 from office365.sharepoint.listitems.listitem import ListItem
+from office365.sharepoint.lists.base_type import is_document_library
 from office365.sharepoint.lists.bloom_filter import ListBloomFilter
 from office365.sharepoint.lists.creatables_info import CreatablesInfo
 from office365.sharepoint.lists.data_source import ListDataSource
@@ -63,11 +71,18 @@ from office365.sharepoint.navigation.configured_metadata_item_col import (
 from office365.sharepoint.pages.wiki_page_creation_information import (
     WikiPageCreationInformation,
 )
+from office365.sharepoint.permissions import SiteLevel, site_access
+from office365.sharepoint.permissions.base_permissions import BasePermissions
 from office365.sharepoint.permissions.securable_object import SecurableObject
 from office365.sharepoint.principal.users.user import User
 from office365.sharepoint.sharing.object_sharing_settings import ObjectSharingSettings
 from office365.sharepoint.sitescripts.utility import SiteScriptUtility
-from office365.sharepoint.thresholds import LIST_VIEW_THRESHOLD, SAFE_PAGE_SIZE, Limits, limit
+from office365.sharepoint.thresholds import (
+    LIST_VIEW_THRESHOLD,
+    SAFE_PAGE_SIZE,
+    Limits,
+    limit,
+)
 from office365.sharepoint.translation.user_resource import UserResource
 from office365.sharepoint.types.resource_path import ResourcePath as SPResPath
 from office365.sharepoint.usercustomactions.collection import UserCustomActionCollection
@@ -77,15 +92,82 @@ from office365.sharepoint.views.view import View
 from office365.sharepoint.webhooks.subscription_collection import SubscriptionCollection
 
 if TYPE_CHECKING:
+    from office365.runtime.converters.coercion import ConverterSpec
     from office365.runtime.converters.dataframe import DataFrameResult
-    from office365.runtime.imports import CheckpointStore, ImportCheckpoint, ImportResult
+    from office365.runtime.imports import (
+        CheckpointStore,
+        ImportCheckpoint,
+        ImportResult,
+    )
     from office365.runtime.operations import ProgressCallback
     from office365.runtime.record_collection import VerificationResult
     from office365.sharepoint.client_context import ClientContext
     from office365.sharepoint.documentmanagement.document_set import DocumentSet
+    from office365.sharepoint.documents.contentassemblyfileinfo import (
+        ContentAssemblyFileInfo,
+    )
+    from office365.sharepoint.documents.contentassemblyformanswer import (
+        ContentAssemblyFormAnswer,
+    )
+    from office365.sharepoint.documents.contentassemblymoderntemplatecolumnsmappinginfo import (
+        ContentAssemblyModernTemplateColumnsMappingInfo,
+    )
+    from office365.sharepoint.documents.createhvcsitemapprovalrequestparameters import (
+        CreateHVCSItemApprovalRequestParameters,
+    )
+    from office365.sharepoint.documents.documentgenerationinfo import (
+        DocumentGenerationInfo,
+    )
+    from office365.sharepoint.documents.fieldvalueswithurl import FieldValuesWithUrl
+    from office365.sharepoint.documents.itemorderupdatevalue import ItemOrderUpdateValue
+    from office365.sharepoint.documents.lockfiledata import LockFileData
+    from office365.sharepoint.documents.placeholderv2 import PlaceholderV2
+    from office365.sharepoint.documents.publishmoderntemplatepayload import (
+        PublishModernTemplatePayload,
+    )
+    from office365.sharepoint.documents.publishsnippetpayload import (
+        PublishSnippetPayload,
+    )
+    from office365.sharepoint.documents.publishtemplatev2payload import (
+        PublishTemplateV2Payload,
+    )
+    from office365.sharepoint.documents.templatemetadata import TemplateMetaData
+    from office365.sharepoint.documents.updatetemplateinfo import UpdateTemplateInfo
+    from office365.sharepoint.documents.updatetemplateinfov2 import UpdateTemplateInfoV2
+    from office365.sharepoint.files.versionbatchdeleteparameters import (
+        FileVersionBatchDeleteParameters,
+    )
+    from office365.sharepoint.lists.extended_share_point_permission_settings import (
+        ExtendedSharePointPermissionSettings,
+    )
+    from office365.sharepoint.lists.listform import ListForm
+    from office365.sharepoint.lists.rules.action import SPRuleAction
+    from office365.sharepoint.lists.templatization_metadata import (
+        TemplatizationMetaData,
+    )
+    from office365.sharepoint.permissions.irm.settings import (
+        InformationRightsManagementSettings,
+    )
     from office365.sharepoint.webs.web import Web
-
-
+    from office365.sharepoint.workflow.associations.association import (
+        WorkflowAssociation,
+    )
+
+
+#: The ceilings on a list's own shape and on what a query against it may do: its item count,
+#: its indexes, who may see those items, and the joins one view may make.
+@limit(
+    Limits.LIST_VIEW_ADMIN,
+    Limits.INDEX_ADD_REMOVE,
+    Limits.DELETE_ITEMS,
+    Limits.MAX_LIST_ITEMS,
+    Limits.MAX_INDEXED_COLUMNS,
+    Limits.LOOKUP_JOINS,
+    Limits.PERMISSION_INHERITANCE,
+    Limits.UNIQUE_SCOPES,
+    Limits.UNIQUE_SCOPES_RECOMMENDED,
+    Limits.ACL_PROPAGATION,
+)
 class List(SecurableObject):
     """
     Represents a list on a SharePoint Web site.
@@ -101,7 +183,9 @@ class List(SecurableObject):
         """Create an alert on this list for the current user."""
 
         def _add_alert(url: str | None) -> None:
-            from office365.sharepoint.alerts.creation_information import AlertCreationInformation
+            from office365.sharepoint.alerts.creation_information import (
+                AlertCreationInformation,
+            )
 
             assert url is not None
             params = AlertCreationInformation(
@@ -150,6 +234,7 @@ class List(SecurableObject):
         self.ensure_property("Title").after_execute(lambda _: _can_customize_forms())
         return return_type
 
+    @site_access(SiteLevel.WRITE)
     def clear(self) -> Self:
         """Clears the list (deletes all items).
 
@@ -158,13 +243,7 @@ class List(SecurableObject):
 
             >>> target_list.clear().execute_batch()
         """
-
-        def _delete_all(items) -> None:
-            # snapshot: delete_object removes items from the collection while iterating
-            [item.delete_object() for item in list(items)]
-
-        items = self.items.select(["Id"]).get_all().execute_query()
-        _delete_all(items)
+        self.items.select(["Id"]).get_all().execute_query().delete_all()
         return self
 
     def create_document_set(self, name: str) -> DocumentSet:
@@ -176,6 +255,7 @@ class List(SecurableObject):
         result = DocumentSet.create(self.context, self.root_folder, name)
         return result
 
+    @site_access(SiteLevel.WRITE)
     def create_document_and_get_edit_link(
         self,
         file_name: Optional[str] = None,
@@ -203,6 +283,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.MANAGE)
     def delete_rule(self, rule_id: str) -> Self:
         """Args:
         rule_id (str):
@@ -212,6 +293,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return self
 
+    @site_access(SiteLevel.READ)
     def get_async_action_config(self) -> ClientResult[Dict]:
         """ """
         return_type = ClientResult[dict](self.context)
@@ -219,6 +301,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.READ)
     def get_bloom_filter(self, start_item_id: Optional[int] = None) -> ListBloomFilter:
         """Generates a Bloom filter (probabilistic structure for checking the existence of list items) for the current
             list
@@ -346,6 +429,7 @@ class List(SecurableObject):
         self.ensure_property("RootFolder").after_execute(lambda _: _list_loaded())
         return return_type
 
+    @site_access(SiteLevel.MANAGE)
     def ensure_signoff_status_field(self) -> Field:
         """"""
         return_type = Field(self.context)
@@ -354,6 +438,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.READ)
     def get_all_rules(self) -> ClientResult[ClientValueCollection[SPListRule]]:
         """Retrieves rules of a List"""
         return_type = ClientResult(self.context, ClientValueCollection(SPListRule))
@@ -361,6 +446,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.READ)
     def get_business_app_operation_status(self) -> FlowSynchronizationResult:
         """ """
         return_type = FlowSynchronizationResult(self.context)
@@ -368,6 +454,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.READ)
     def search_lookup_field_choices(
         self, target_field_name: str, begins_with_search_string: str, paging_info: str
     ) -> FlowSynchronizationResult:
@@ -386,6 +473,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.WRITE)
     def sync_flow_callback_url(self, flow_id: str) -> FlowSynchronizationResult:
         """Args:
         flow_id (str):
@@ -395,6 +483,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.WRITE)
     def sync_flow_instance(self, flow_id: str) -> FlowSynchronizationResult:
         """Args:
         flow_id (str):
@@ -404,6 +493,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.WRITE)
     def sync_flow_instances(self, retrieve_group_flows: bool) -> FlowSynchronizationResult:
         """Args:
         retrieve_group_flows (bool):
@@ -414,6 +504,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.WRITE)
     def sync_flow_templates(self, category: str) -> FlowSynchronizationResult:
         """Args:
         category (str):
@@ -424,6 +515,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.WRITE)
     def create_document_with_default_name(self, folder_path: str, extension: str):
         """Creates a empty document with default filename with the given extension at the path given by folderPath.
         Returns the name of the newly created document.
@@ -438,13 +530,21 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
-    def recycle(self) -> ClientResult[str]:
-        """Moves the list to the Recycle Bin and returns the identifier of the new Recycle Bin item."""
+    @site_access(SiteLevel.WRITE)
+    def recycle(self, ignore_missing: bool = False) -> ClientResult[str]:
+        """Moves the list to the Recycle Bin and returns the identifier of the new Recycle Bin item.
+
+        Args:
+            ignore_missing (bool): When True, recycling a list that no longer
+                exists (HTTP 404) succeeds instead of raising.
+        """
         return_type = ClientResult[str](self.context)
         qry = ServiceOperationQuery(self, "Recycle", None, None, None, return_type)
         self.context.add_query(qry)
+        self._tolerate_missing(ignore_missing)
         return return_type
 
+    @site_access(SiteLevel.WRITE)
     def start_recycle(self) -> ClientResult[str]:
         """Moves the list to the Recycle Bin and returns the identifier of the new Recycle Bin item."""
         return_type = ClientResult(self.context, str())
@@ -452,6 +552,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.READ)
     def render_list_data(self, view_xml: str) -> ClientResult[bytes]:
         """Returns the data for the specified query view. The result is implementation-specific, used for
         providing data to a user interface.
@@ -467,6 +568,7 @@ class List(SecurableObject):
         return return_type
 
     @staticmethod
+    @site_access(SiteLevel.READ)
     def get_list_data_as_stream(
         context: ClientContext,
         list_full_url: str,
@@ -507,6 +609,7 @@ class List(SecurableObject):
         return return_type
 
     @staticmethod
+    @site_access(SiteLevel.READ)
     def get_onedrive_list_data_as_stream(
         context: ClientContext,
         parameters: Optional[RenderListDataParameters] = None,
@@ -536,6 +639,7 @@ class List(SecurableObject):
         context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.WRITE)
     def bulk_validate_update_list_items(
         self,
         item_ids,
@@ -568,6 +672,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.READ)
     def get_lookup_field_choices(self, target_field_name: str, paging_info: Optional[str] = None) -> ClientResult[str]:
         """Retrieves the possible choices or values for a lookup field in a SharePoint list
 
@@ -581,6 +686,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.READ)
     def get_list_item_changes_since_token(self, query: ChangeLogItemQuery) -> ClientResult[AnyStr]:
         """
         Returns the changes made to the list since the date and time specified in the change token defined
@@ -592,6 +698,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type  # type: ignore[return-type]
 
+    @site_access(SiteLevel.MANAGE)
     def save_as_new_view(self, old_name: str, new_name: str, private_view: bool, uri: str) -> ClientResult[str]:
         """Overwrites a view if it already exists, creates a new view if it does not; and then extracts the
         implementation-specific filter and sort information from the URL and builds and updates the view's XML.
@@ -614,6 +721,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.MANAGE)
     def save_as_template(self, file_name: str, name: str, description: str, save_data: bool) -> Self:
         """Saves the list as a template in the list template gallery and includes the option of saving with or
         without the data that is contained in the current list.
@@ -645,6 +753,7 @@ class List(SecurableObject):
             ServiceOperationPath("getItemByUniqueId", [unique_id], self.resource_path),
         )
 
+    @site_access(SiteLevel.READ)
     def get_web_dav_url(self, source_url: str) -> ClientResult[str]:
         """Gets the trusted URL for opening the folder in Explorer view.
 
@@ -678,6 +787,7 @@ class List(SecurableObject):
         """
         return caml_query.index_candidates
 
+    @site_access(SiteLevel.READ)
     def check_query(self, caml_query: CamlQuery, *, item_count: Optional[int] = None) -> None:
         """Pre-flight a CAML query against the SharePoint list view threshold.
 
@@ -719,6 +829,7 @@ class List(SecurableObject):
             )
 
     @limit(Limits.LIST_VIEW, arg="page_size")
+    @site_access(SiteLevel.READ)
     def get_items(
         self,
         caml_query: Optional[CamlQuery] = None,
@@ -772,7 +883,7 @@ class List(SecurableObject):
 
     def ensure_field(
         self,
-        name: str,
+        name: "str | FieldCreationInformation",
         field_type: FieldType = FieldType.Text,
         description: str | None = None,
         *,
@@ -780,43 +891,62 @@ class List(SecurableObject):
     ) -> Field:
         """Ensure a single column exists on the list, creating it if missing.
 
+        Pass a column ``name`` for a basic column — with an optional ``field_type``
+        and ``description`` — or a populated :class:`FieldCreationInformation` for
+        a rich one (``Choices`` for Choice/MultiChoice, ``Formula`` for Calculated,
+        ``Required``, ``LookupListId``/``LookupFieldName`` for Lookup, ...)::
+
+            lst.ensure_field("Status", FieldType.Choice)
+            lst.ensure_field(
+                FieldCreationInformation(Title="Status", FieldTypeKind=FieldType.Choice, Choices=["A", "B"])
+            )
+
         The check is deferred — the column is looked up and created when the
         caller executes the query (e.g. ``list.ensure_field("Status").execute_query()``).
-        With ``on_conflict="update"`` an existing column's type/description is
-        reconciled.
+        With ``on_conflict="update"`` an existing column's type/description and rich
+        settings (choices, formula, required) are reconciled.
 
         Args:
-            name: The column title
-            field_type: The field type to create it with if missing (Text by default)
-            description: The description of the column
+            name: The column title, or a ``FieldCreationInformation`` describing it.
+            field_type: The field type to create it with if missing (Text by default).
+            description: The description of the column.
             on_conflict: ``"skip"`` (default) or ``"update"``.
 
         Returns:
             Field: The existing or newly created field.
         """
-        return self.fields.ensure(
-            FieldCreationInformation(Title=name, FieldTypeKind=field_type, Description=description),
-            on_conflict=on_conflict,
-        )
+        if isinstance(name, FieldCreationInformation):
+            info = name
+        else:
+            info = FieldCreationInformation(Title=name, FieldTypeKind=field_type, Description=description)
+        return self.fields.ensure(info, on_conflict=on_conflict)
 
-    def ensure_fields(self, columns: "Dict[str, FieldType] | list[str]", *, on_conflict: str = "skip") -> list[Field]:
+    def ensure_fields(
+        self,
+        columns: "Mapping[str, FieldType] | Sequence[str | FieldCreationInformation]",
+        *,
+        on_conflict: str = "skip",
+    ) -> list[Field]:
         """Ensure the specified columns exist on the list, creating missing ones.
 
         Reconciles the source schema with the target list before data import:
         existing fields are kept (or reconciled with ``on_conflict="update"``),
-        missing ones are created with the given type (Text by default). Deferred —
-        execute the query after.
+        missing ones are created (Text by default). Deferred — execute the query
+        after.
 
         Args:
-            columns: Either a list of field names (created as Text) or a mapping
-                of field name -> FieldType
+            columns: A mapping of field name -> :class:`FieldType` (basic columns),
+                or a sequence of names (created as Text) and/or
+                :class:`FieldCreationInformation` specs for rich columns
+                (choice/lookup/calculated/...).
             on_conflict: ``"skip"`` (default) or ``"update"``.
 
         Returns:
             list[Field]: The existing or newly created fields.
         """
-        spec = columns.items() if isinstance(columns, dict) else ((c, FieldType.Text) for c in columns)
-        return [self.ensure_field(name, field_type, on_conflict=on_conflict) for name, field_type in spec]
+        if isinstance(columns, Mapping):
+            return [self.ensure_field(name, field_type, on_conflict=on_conflict) for name, field_type in columns.items()]
+        return [self.ensure_field(column, on_conflict=on_conflict) for column in columns]
 
     def ensure_indexed(self, name: str) -> Field:
         """Enable the index on an existing column (idempotent, deferred).
@@ -829,6 +959,7 @@ class List(SecurableObject):
         """
         return self.fields.get_by_internal_name_or_title(name).ensure_indexed()
 
+    @site_access(SiteLevel.WRITE)
     def from_records(
         self,
         source,
@@ -848,6 +979,7 @@ class List(SecurableObject):
         on_schema_change: str = "evolve",
         dead_letter: "str | None" = None,
         mapping: "Dict[str, str] | None" = None,
+        coerce: "Dict[str, ConverterSpec] | None" = None,
     ) -> "ImportResult":
         """Stream a source into this list's items, memory-bounded (streaming entry).
 
@@ -868,7 +1000,14 @@ class List(SecurableObject):
             format: Source format (default ``"records"``).
             schema: Optional explicit ``{column: FieldType}``; inferred from dtypes.
                 A ``FieldType`` also drives typed value coercion (multi-choice,
-                lookup, user, URL, geolocation, ...).
+                lookup, user, URL, geolocation, ...). A list item's field types are
+                not declared on ``ListItem``, so this is the only place they can be
+                stated -- ``coerce`` is the same mechanism with the general arms.
+            coerce: Optional ``{column: converter}`` for a cell the field type does not
+                describe: a callable, a Python type, a type name or a ``FieldType``
+                (see :func:`~office365.runtime.converters.coercion.converter_for`).
+                Keys are column names as they appear in the source; an entry here wins
+                over the ``schema`` entry for the same column.
             chunksize: Rows per chunk for a DataFrame/CSV source.
             progress: Optional hook fired live (initial, per chunk, per batch).
             total: Total rows when known upfront (drives the progress percentage).
@@ -876,7 +1015,7 @@ class List(SecurableObject):
             on_error: ``"raise"`` (default) or ``"collect"``.
             key: Natural-key source column(s) for idempotency; ``None`` disables it.
             key_field: Target column storing the derived key hash.
-            on_conflict: ``"skip"`` (default) or ``"upsert"``.
+            on_conflict: ``"skip"`` (default) or ``"update"``.
             enforce_unique: Mark the key column unique (guards a create race).
             dry_run: Plan the create/update/skip counts without writing.
             on_schema_change: ``"evolve"`` (default) or ``"fail"``.
@@ -886,21 +1025,21 @@ class List(SecurableObject):
         Returns:
             ImportResult: The deferred streaming import driver.
         """
-        from functools import partial
-
         from office365.runtime.converters.dataframe import records_from_dataframe
-        from office365.sharepoint.fields.coercion import coerce_field_value
         from office365.sharepoint.fields.name import internal_field_name
 
         if on_schema_change not in ("evolve", "fail"):
             raise ValueError(f"on_schema_change must be 'evolve' or 'fail', got {on_schema_change!r}")
         provisioned: set[str] = set()
-        coercions: "Dict[str, Any] | None" = None
-        if isinstance(schema, dict):
-            coercions = {
-                internal_field_name(str(column)): partial(coerce_field_value, field_type)
-                for column, field_type in schema.items()
-            }
+        coercions: "Dict[str, ConverterSpec]" = {}
+        if isinstance(schema, dict) or coerce:
+            # A DataFrame/CSV chunk is renamed to internal field names on the way in, so
+            # the coercion keys are too. A `records` batch arrives as the caller spelled
+            # it, so its keys are taken verbatim.
+            spelled = internal_field_name if format in ("dataframe", "csv") else str
+            coercions = {spelled(str(column)): field_type for column, field_type in (schema or {}).items()}
+            for column, spec in (coerce or {}).items():
+                coercions[spelled(str(column))] = spec
 
         def _mapped(chunk: Any) -> Any:
             if mapping and hasattr(chunk, "rename"):
@@ -1074,6 +1213,25 @@ class List(SecurableObject):
             self.items.get_all().export_to(target, format=format, **opts)
         return self
 
+    async def export_to_async(self, target, *, format: str = "csv", page_size=None, **opts) -> Self:  # noqa: A002
+        """Async twin of :meth:`export_to`.
+
+        The list's items are paged and written on the worker pool, so the event
+        loop stays free; pass ``page_size`` to stream an appendable format page by
+        page (bounded memory) or omit it to load and write the whole collection.
+
+            >>> await lst.export_to_async("items.csv", page_size=2000)
+        """
+        items = self.items
+        if page_size:
+            await items.export_to_async(target, format=format, page_size=page_size, **opts)
+        else:
+            # `List.items` builds a new collection per access, so keep one
+            # reference: load it, then export the loaded items.
+            await items.get_all_async()
+            await items.export_to_async(target, format=format, **opts)
+        return self
+
     def to_dataframe(self) -> "DataFrameResult":
         """Export this list's items to a pandas DataFrame (deferred result)."""
         return self.items.get_all().to_dataframe()
@@ -1090,6 +1248,7 @@ class List(SecurableObject):
         """Export this list's items to Feather (deferred; requires the ``[parquet]`` extra)."""
         return self.export_to(target, format="feather")
 
+    @site_access(SiteLevel.WRITE)
     def add_item(self, creation_information: Union[ListItemCreationInformation, Dict]) -> ListItem:
         """The recommended way to add a list item is to send a POST request to the ListItemCollection resource endpoint,
         as shown in ListItemCollection request examples."""
@@ -1134,6 +1293,7 @@ class List(SecurableObject):
         )
         return return_type
 
+    @site_access(SiteLevel.WRITE)
     def add_item_using_path(self, leaf_name: str, object_type: int, folder_url: str) -> ListItem:
         """Adds a ListItem to an existing List.
 
@@ -1154,6 +1314,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.WRITE)
     def add_validate_update_item(
         self, create_info: ListItemCreationInformation, form_values: Optional[Dict] = None
     ) -> ClientResult[ClientValueCollection[ListItemFormUpdateValue]]:
@@ -1212,6 +1373,7 @@ class List(SecurableObject):
             self,
         )
 
+    @site_access(SiteLevel.READ)
     def get_changes(self, query: Optional[ChangeQuery] = None) -> ChangeCollection:
         """Returns the collection of changes from the change log that have occurred within the list,
         based on the specified query.
@@ -1227,6 +1389,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.READ)
     def get_checked_out_files(self) -> CheckedOutFileCollection:
         """Returns a collection of checked-out files as specified in section 3.2.5.381."""
         return_type = CheckedOutFileCollection(
@@ -1237,6 +1400,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.READ)
     def render_list_data_as_stream(
         self,
         view_xml: Optional[str] = None,
@@ -1264,6 +1428,7 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    @site_access(SiteLevel.WRITE)
     def reserve_list_item_id(self) -> ClientResult[int]:
         """Reserves the returned list item identifier for the idempotent creation of a list item."""
         return_type = ClientResult(self.context, int())
@@ -1281,6 +1446,7 @@ class List(SecurableObject):
             ServiceOperationPath("getRelatedFields", [], self.resource_path),
         )
 
+    @site_access(SiteLevel.READ)
     def get_special_folder_url(
         self, folder_type: int, force_create: bool, existing_folder_guid: str
     ) -> ClientResult[str]:
@@ -1317,6 +1483,7 @@ class List(SecurableObject):
         self.ensure_property("RootFolder").after_execute(lambda _: _reset_doc_ids(self.root_folder.server_relative_url))
         return self
 
+    @site_access(SiteLevel.MANAGE)
     def set_exempt_from_block_download_of_non_viewable_files(self, value: bool) -> Self:
         """
         Method to set the ExemptFromBlockDownloadOfNonViewableFiles property.
@@ -1333,40 +1500,48 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return self
 
+    @odata(name="Id", readonly=True)
     @property
     def id(self) -> Optional[str]:
         """Gets a value that specifies the list identifier."""
         return self.properties.get("Id", None)
 
+    @odata(name="AdditionalUXProperties", readonly=True, beta=True)
     @property
     def additional_ux_properties(self) -> Optional[str]:
         return self.properties.get("AdditionalUXProperties", None)
 
+    @odata(name="Author", navigation=True, beta=True)
     @property
     def author(self) -> User:
         """Specifies the user who created the list."""
         return self.properties.get("Author", User(self.context, ResourcePath("Author", self.resource_path)))
 
+    @odata(name="AllowContentTypes", readonly=True)
     @property
     def allow_content_types(self) -> Optional[bool]:
         """Specifies whether the list supports content types."""
         return self.properties.get("AllowContentTypes", None)
 
+    @odata(name="AllowDeletion")
     @property
     def allow_deletion(self) -> Optional[bool]:
         """Specifies whether the list could be deleted."""
         return self.properties.get("AllowDeletion", None)
 
+    @odata(name="Hidden")
     @property
     def hidden(self) -> Optional[bool]:
         """Specifies whether the list is hidden from UI."""
         return self.properties.get("Hidden", None)
 
+    @odata(name="BaseTemplate", readonly=True)
     @property
     def base_template(self) -> Optional[int]:
         """Specifies the list server template of the list."""
         return self.properties.get("BaseTemplate", None)
 
+    @odata(name="BaseType", readonly=True)
     @property
     def base_type(self) -> Optional[int]:
         """
@@ -1375,6 +1550,16 @@ class List(SecurableObject):
         """
         return self.properties.get("BaseType", None)
 
+    @property
+    def is_document_library(self) -> bool:
+        """Whether this list holds files rather than records, read off its ``BaseType``.
+
+        Derived rather than declared: ``BaseType`` is what the service reports, and this
+        is the question every caller asks of it.
+        """
+        return is_document_library(self.base_type)
+
+    @odata(name="BrowserFileHandling", readonly=True)
     @property
     def browser_file_handling(self) -> Optional[int]:
         """
@@ -1385,22 +1570,25 @@ class List(SecurableObject):
         """
         return self.properties.get("BrowserFileHandling", None)
 
+    @odata(name="Created", readonly=True)
     @property
     def created(self) -> datetime:
         """Specifies when the list was created."""
         return self.properties.get("Created", datetime.min)
 
+    @odata(name="DefaultDisplayFormUrl")
     @property
     def default_display_form_url(self) -> Optional[str]:
         """Specifies the location of the default display form for the list."""
         return self.properties.get("DefaultDisplayFormUrl", None)
 
-    @odata(name="DefaultViewPath")
+    @odata(name="DefaultViewPath", readonly=True)
     @property
     def default_view_path(self) -> SPResPath:
         """Specifies the server-relative URL of the default view for the list."""
         return self.properties.get("DefaultViewPath", SPResPath())
 
+    @odata(name="DefaultViewUrl", readonly=True)
     @property
     def default_view_url(self) -> Optional[str]:
         """
@@ -1408,6 +1596,7 @@ class List(SecurableObject):
         """
         return self.properties.get("DefaultViewUrl", None)
 
+    @odata(name="CrawlNonDefaultViews")
     @property
     def crawl_non_default_views(self) -> Optional[bool]:
         """
@@ -1416,7 +1605,7 @@ class List(SecurableObject):
         """
         return self.properties.get("CrawlNonDefaultViews", None)
 
-    @odata(name="CreatablesInfo")
+    @odata(name="CreatablesInfo", navigation=True)
     @property
     def creatables_info(self) -> CreatablesInfo:
         """
@@ -1433,7 +1622,7 @@ class List(SecurableObject):
             CreatablesInfo(self.context, ResourcePath("CreatablesInfo", self.resource_path)),
         )
 
-    @odata(name="CurrentChangeToken")
+    @odata(name="CurrentChangeToken", readonly=True)
     @property
     def current_change_token(self) -> ChangeToken:
         """Gets the current change token that is used in the change log for the list."""
@@ -1448,15 +1637,18 @@ class List(SecurableObject):
         """
         return self.properties.get("DataSource", ListDataSource())
 
+    @odata(name="DefaultEditFormUrl")
     @property
     def default_edit_form_url(self) -> Optional[str]:
         """Gets a value that specifies the URL of the edit form to use for list items in the list."""
         return self.properties.get("DefaultEditFormUrl", None)
 
+    @odata(name="DefaultItemOpenInBrowser", beta=True)
     @property
     def default_item_open_in_browser(self) -> Optional[bool]:
         return self.properties.get("DefaultItemOpenInBrowser", None)
 
+    @odata(name="DefaultItemOpenUseListSetting", readonly=True, beta=True)
     @property
     def default_item_open_use_list_setting(self) -> Optional[bool]:
         """
@@ -1466,32 +1658,33 @@ class List(SecurableObject):
         """
         return self.properties.get("DefaultItemOpenUseListSetting", None)
 
+    @odata(name="DisableCommenting")
     @property
     def disable_commenting(self) -> Optional[bool]:
         return self.properties.get("DisableCommenting", None)
 
+    @odata(name="DisableGridEditing")
     @property
     def disable_grid_editing(self) -> Optional[bool]:
         return self.properties.get("DisableGridEditing", None)
 
+    @odata(name="DocumentTemplateUrl")
     @property
     def document_template_url(self) -> Optional[str]:
         """Specifies the URL of the document template assigned to the list."""
         return self.properties.get("DocumentTemplateUrl", None)
 
-    @odata(name="EffectiveBasePermissions")
+    @odata(name="EffectiveBasePermissions", readonly=True)
     @property
-    def effective_base_permissions(self):
+    def effective_base_permissions(self) -> BasePermissions:
         """
         Specifies the effective permissions on the list that are assigned to the current user.
         """
-        from office365.sharepoint.permissions.base_permissions import BasePermissions
-
         return self.properties.get("EffectiveBasePermissions", BasePermissions())
 
-    @odata(name="EffectiveBasePermissionsForUI")
+    @odata(name="EffectiveBasePermissionsForUI", readonly=True)
     @property
-    def effective_base_permissions_for_ui(self):
+    def effective_base_permissions_for_ui(self) -> BasePermissions:
         """
         Specifies the effective base permissions for the current user as they SHOULD be displayed in user interface (UI)
         If the list is not in read-only UI mode, the value of EffectiveBasePermissionsForUI MUST be the same as the
@@ -1502,6 +1695,7 @@ class List(SecurableObject):
 
         return self.properties.get("EffectiveBasePermissionsForUI", BasePermissions())
 
+    @odata(name="EnableAssignToEmail")
     @property
     def enable_assign_to_email(self) -> Optional[bool]:
         """
@@ -1509,11 +1703,13 @@ class List(SecurableObject):
         """
         return self.properties.get("EnableAssignToEmail", None)
 
+    @odata(name="EnableAttachments")
     @property
     def enable_attachments(self) -> Optional[bool]:
         """Specifies whether list item attachments are enabled for the list"""
         return self.properties.get("EnableAttachments", None)
 
+    @odata(name="EnableFolderCreation")
     @property
     def enable_folder_creation(self) -> Optional[bool]:
         """Specifies whether new list folders can be added to the list."""
@@ -1523,25 +1719,30 @@ class List(SecurableObject):
     def enable_folder_creation(self, value: bool) -> None:
         self.set_property("EnableFolderCreation", value, True)
 
+    @odata(name="EnableMinorVersions")
     @property
     def enable_minor_versions(self) -> Optional[bool]:
         """Specifies whether minor versions are enabled for the list."""
         return self.properties.get("EnableMinorVersions", None)
 
+    @odata(name="EnableModeration")
     @property
     def enable_moderation(self) -> Optional[bool]:
         """Specifies whether content approval is enabled for the list."""
         return self.properties.get("EnableModeration", None)
 
+    @odata(name="EnableRequestSignOff")
     @property
     def enable_request_sign_off(self) -> Optional[bool]:
         return self.properties.get("EnableRequestSignOff", None)
 
+    @odata(name="EnableVersioning")
     @property
     def enable_versioning(self) -> Optional[bool]:
         """Specifies whether content approval is enabled for the list."""
         return self.properties.get("EnableVersioning", None)
 
+    @odata(name="ExcludeFromOfflineClient")
     @property
     def exclude_from_offline_client(self) -> Optional[bool]:
         """
@@ -1550,6 +1751,7 @@ class List(SecurableObject):
         """
         return self.properties.get("ExcludeFromOfflineClient", None)
 
+    @odata(name="ExemptFromBlockDownloadOfNonViewableFiles", readonly=True, beta=True)
     @property
     def exempt_from_block_download_of_non_viewable_files(self) -> Optional[bool]:
         """
@@ -1558,6 +1760,7 @@ class List(SecurableObject):
         """
         return self.properties.get("ExemptFromBlockDownloadOfNonViewableFiles", None)
 
+    @odata(name="FileSavePostProcessingEnabled", readonly=True)
     @property
     def file_save_post_processing_enabled(self) -> Optional[bool]:
         """
@@ -1566,16 +1769,19 @@ class List(SecurableObject):
         """
         return self.properties.get("FileSavePostProcessingEnabled", None)
 
+    @odata(name="ForceCheckout")
     @property
     def force_checkout(self) -> Optional[bool]:
         """Specifies whether check out is required when adding or editing documents in the list"""
         return self.properties.get("ForceCheckout", None)
 
+    @odata(name="HasContentAssemblyTemplates", beta=True)
     @property
     def has_content_assembly_templates(self) -> Optional[bool]:
         """ """
         return self.properties.get("HasContentAssemblyTemplates", None)
 
+    @odata(name="HasExternalDataSource", readonly=True)
     @property
     def has_external_data_source(self) -> Optional[bool]:
         """
@@ -1583,16 +1789,19 @@ class List(SecurableObject):
         """
         return self.properties.get("HasExternalDataSource", None)
 
+    @odata(name="HasFolderColoringFields", readonly=True, beta=True)
     @property
     def has_folder_coloring_fields(self) -> Optional[bool]:
         """ """
         return self.properties.get("HasFolderColoringFields", None)
 
+    @odata(name="IrmEnabled")
     @property
     def irm_enabled(self) -> Optional[bool]:
         """Gets a Boolean value that specifies whether Information Rights Management (IRM) is enabled for the list."""
         return self.properties.get("IrmEnabled", None)
 
+    @odata(name="IrmExpire", readonly=True)
     @property
     def irm_expire(self) -> Optional[bool]:
         """Gets a Boolean value that specifies whether Information Rights Management (IRM) expiration is enabled
@@ -1600,6 +1809,7 @@ class List(SecurableObject):
         """
         return self.properties.get("IrmExpire", None)
 
+    @odata(name="Items", navigation=True)
     @property
     def items(self) -> ListItemCollection:
         """Get list items"""
@@ -1608,7 +1818,7 @@ class List(SecurableObject):
             ListItemCollection(self.context, ResourcePath("items", self.resource_path), parent=self),
         )
 
-    @odata(name="RootFolder")
+    @odata(name="RootFolder", navigation=True)
     @property
     def root_folder(self) -> Folder:
         """Get a root folder"""
@@ -1617,6 +1827,7 @@ class List(SecurableObject):
             Folder(self.context, ResourcePath("RootFolder", self.resource_path)),
         )
 
+    @odata(name="Fields", navigation=True)
     @property
     def fields(self) -> FieldCollection:
         """Gets a value that specifies the collection of all fields in the list."""
@@ -1625,6 +1836,7 @@ class List(SecurableObject):
             FieldCollection(self.context, ResourcePath("Fields", self.resource_path), self),
         )
 
+    @odata(name="Subscriptions", navigation=True)
     @property
     def subscriptions(self) -> SubscriptionCollection:
         """Gets one or more webhook subscriptions on a SharePoint list."""
@@ -1633,6 +1845,7 @@ class List(SecurableObject):
             SubscriptionCollection(self.context, ResourcePath("Subscriptions", self.resource_path), self),
         )
 
+    @odata(name="Views", navigation=True)
     @property
     def views(self) -> ViewCollection:
         """Gets a value that specifies the collection of all public views on the list and personal views
@@ -1642,7 +1855,7 @@ class List(SecurableObject):
             ViewCollection(self.context, ResourcePath("views", self.resource_path), self),
         )
 
-    @odata(name="DefaultView")
+    @odata(name="DefaultView", navigation=True)
     @property
     def default_view(self) -> View:
         """Gets or sets a value that specifies whether the list view is the default list view."""
@@ -1651,7 +1864,7 @@ class List(SecurableObject):
             View(self.context, ResourcePath("DefaultView", self.resource_path), self),
         )
 
-    @odata(name="ContentTypes")
+    @odata(name="ContentTypes", navigation=True)
     @property
     def content_types(self) -> ContentTypeCollection:
         """Gets the content types that are associated with the list."""
@@ -1660,11 +1873,13 @@ class List(SecurableObject):
             ContentTypeCollection(self.context, ResourcePath("ContentTypes", self.resource_path), self),
         )
 
+    @odata(name="ContentTypesEnabled")
     @property
     def content_types_enabled(self) -> Optional[bool]:
         """Specifies whether content types are enabled for the list."""
         return self.properties.get("ContentTypesEnabled", None)
 
+    @odata(name="IsPrivate", readonly=True)
     @property
     def is_private(self) -> Optional[bool]:
         """
@@ -1673,6 +1888,7 @@ class List(SecurableObject):
         """
         return self.properties.get("IsPrivate", None)
 
+    @odata(name="IsSiteAssetsLibrary", readonly=True)
     @property
     def is_site_assets_library(self) -> Optional[bool]:
         """
@@ -1681,6 +1897,7 @@ class List(SecurableObject):
         """
         return self.properties.get("IsSiteAssetsLibrary", None)
 
+    @odata(name="IsSystemList", readonly=True, beta=True)
     @property
     def is_system_list(self) -> Optional[bool]:
         """
@@ -1689,7 +1906,7 @@ class List(SecurableObject):
         """
         return self.properties.get("IsSystemList", None)
 
-    @odata(name="UserCustomActions")
+    @odata(name="UserCustomActions", navigation=True)
     @property
     def user_custom_actions(self) -> UserCustomActionCollection:
         """Gets the User Custom Actions that are associated with the list."""
@@ -1698,7 +1915,7 @@ class List(SecurableObject):
             UserCustomActionCollection(self.context, ResourcePath("UserCustomActions", self.resource_path)),
         )
 
-    @odata(name="VersionPolicies")
+    @odata(name="VersionPolicies", navigation=True, beta=True)
     @property
     def version_policies(self) -> VersionPolicyManager:
         """ """
@@ -1712,6 +1929,7 @@ class List(SecurableObject):
     def custom_action_elements(self) -> CustomActionElementCollection:
         return self.properties.get("CustomActionElements", CustomActionElementCollection())
 
+    @odata(name="Forms", navigation=True)
     @property
     def forms(self) -> FormCollection:
         """Gets a value that specifies the collection of all list forms in the list."""
@@ -1720,7 +1938,7 @@ class List(SecurableObject):
             FormCollection(self.context, ResourcePath("forms", self.resource_path)),
         )
 
-    @odata(name="ParentWeb")
+    @odata(name="ParentWeb", navigation=True)
     @property
     def parent_web(self) -> Web:
         """Gets a value that specifies the web where list resides."""
@@ -1731,7 +1949,7 @@ class List(SecurableObject):
             Web(self.context, ResourcePath("parentWeb", self.resource_path)),
         )
 
-    @odata(name="EventReceivers")
+    @odata(name="EventReceivers", navigation=True)
     @property
     def event_receivers(self) -> EventReceiverDefinitionCollection:
         """Get Event receivers"""
@@ -1740,12 +1958,13 @@ class List(SecurableObject):
             EventReceiverDefinitionCollection(self.context, ResourcePath("eventReceivers", self.resource_path), self),
         )
 
+    @odata(name="ItemCount", readonly=True)
     @property
     def item_count(self) -> Optional[int]:
         """Gets a value that specifies the number of list items in the list"""
         return self.properties.get("ItemCount", None)
 
-    @odata(name="LastItemDeletedDate")
+    @odata(name="LastItemDeletedDate", readonly=True)
     @property
     def last_item_deleted_date(self) -> Optional[datetime]:
         """
@@ -1754,7 +1973,7 @@ class List(SecurableObject):
         """
         return self.properties.get("LastItemDeletedDate", None)
 
-    @odata(name="LastItemModifiedDate")
+    @odata(name="LastItemModifiedDate", readonly=True)
     @property
     def last_item_modified_date(self) -> Optional[datetime]:
         """
@@ -1763,7 +1982,7 @@ class List(SecurableObject):
         """
         return self.properties.get("LastItemModifiedDate", None)
 
-    @odata(name="LastItemUserModifiedDate")
+    @odata(name="LastItemUserModifiedDate", readonly=True)
     @property
     def last_item_user_modified_date(self) -> Optional[datetime]:
         """
@@ -1771,6 +1990,7 @@ class List(SecurableObject):
         """
         return self.properties.get("LastItemUserModifiedDate", None)
 
+    @odata(name="ListExperienceOptions")
     @property
     def list_experience_options(self) -> Optional[int]:
         """
@@ -1778,11 +1998,13 @@ class List(SecurableObject):
         """
         return self.properties.get("ListExperienceOptions", None)
 
+    @odata(name="ListFormCustomized", beta=True)
     @property
     def list_form_customized(self) -> Optional[bool]:
         """ """
         return self.properties.get("ListFormCustomized", None)
 
+    @odata(name="ListItemEntityTypeFullName", readonly=True)
     @property
     def list_item_entity_type_full_name(self) -> Optional[str]:
         """
@@ -1790,6 +2012,7 @@ class List(SecurableObject):
         """
         return self.properties.get("ListItemEntityTypeFullName", None)
 
+    @odata(name="MajorVersionLimit")
     @property
     def major_version_limit(self) -> Optional[int]:
         """
@@ -1798,11 +2021,13 @@ class List(SecurableObject):
         """
         return self.properties.get("MajorVersionLimit", None)
 
+    @odata(name="ListSchemaVersion", readonly=True, beta=True)
     @property
     def list_schema_version(self) -> Optional[str]:
         """"""
         return self.properties.get("ListSchemaVersion", None)
 
+    @odata(name="MajorWithMinorVersionsLimit")
     @property
     def major_with_minor_versions_limit(self) -> Optional[int]:
         """
@@ -1811,6 +2036,7 @@ class List(SecurableObject):
         """
         return self.properties.get("MajorWithMinorVersionsLimit", None)
 
+    @odata(name="NoCrawl")
     @property
     def no_crawl(self) -> Optional[bool]:
         """
@@ -1818,6 +2044,7 @@ class List(SecurableObject):
         """
         return self.properties.get("NoCrawl", None)
 
+    @odata(name="OnQuickLaunch")
     @property
     def on_quick_launch(self) -> Optional[bool]:
         """
@@ -1826,6 +2053,7 @@ class List(SecurableObject):
         """
         return self.properties.get("OnQuickLaunch", None)
 
+    @odata(name="PageRenderType", readonly=True, beta=True)
     @property
     def page_render_type(self) -> Optional[int]:
         """
@@ -1835,6 +2063,7 @@ class List(SecurableObject):
         """
         return self.properties.get("PageRenderType", None)
 
+    @odata(name="ParentWebUrl", readonly=True)
     @property
     def parent_web_url(self) -> Optional[str]:
         """
@@ -1843,6 +2072,7 @@ class List(SecurableObject):
         """
         return self.properties.get("ParentWebUrl", None)
 
+    @odata(name="ParserDisabled", readonly=True)
     @property
     def parser_disabled(self) -> Optional[str]:
         """
@@ -1851,11 +2081,13 @@ class List(SecurableObject):
         """
         return self.properties.get("ParserDisabled", None)
 
+    @odata(name="ReadSecurity")
     @property
     def read_security(self) -> Optional[int]:
         """Gets or sets the Read security setting for the list."""
         return self.properties.get("ReadSecurity", None)
 
+    @odata(name="ServerTemplateCanCreateFolders", readonly=True)
     @property
     def server_template_can_create_folders(self) -> Optional[bool]:
         """
@@ -1863,10 +2095,12 @@ class List(SecurableObject):
         """
         return self.properties.get("ServerTemplateCanCreateFolders", None)
 
+    @odata(name="ShowHiddenFieldsInModernForm", beta=True)
     @property
     def show_hidden_fields_in_modern_form(self) -> Optional[bool]:
         return self.properties.get("ShowHiddenFieldsInModernForm", None)
 
+    @odata(name="Title")
     @property
     def title(self) -> Optional[str]:
         """Gets the displayed title for the list."""
@@ -1877,6 +2111,7 @@ class List(SecurableObject):
         """Sets the displayed title for the list."""
         self.set_property("Title", val)
 
+    @odata(name="DefaultContentApprovalWorkflowId", readonly=True)
     @property
     def default_content_approval_workflow_id(self) -> Optional[str]:
         """
@@ -1885,6 +2120,7 @@ class List(SecurableObject):
         """
         return self.properties.get("DefaultContentApprovalWorkflowId", None)
 
+    @odata(name="Description")
     @property
     def description(self) -> Optional[str]:
         """Gets the description for the list."""
@@ -1895,7 +2131,7 @@ class List(SecurableObject):
         """Sets the description for the list."""
         self.set_property("Description", val)
 
-    @odata(name="DescriptionResource")
+    @odata(name="DescriptionResource", navigation=True)
     @property
     def description_resource(self) -> UserResource:
         """Represents the description of this list."""
@@ -1904,17 +2140,19 @@ class List(SecurableObject):
             UserResource(self.context, ResourcePath("DescriptionResource", self.resource_path)),
         )
 
-    @odata(name="ParentWebPath")
+    @odata(name="ParentWebPath", readonly=True)
     @property
     def parent_web_path(self) -> SPResPath:
         """Returns the path of the parent web for the list."""
         return self.properties.get("ParentWebPath", SPResPath())
 
+    @odata(name="SchemaXml", readonly=True)
     @property
     def schema_xml(self) -> Optional[str]:
         """Specifies the list schema of the list."""
         return self.properties.get("SchemaXml", None)
 
+    @odata(name="TemplateFeatureId", readonly=True)
     @property
     def template_feature_id(self) -> Optional[str]:
         """
@@ -1923,7 +2161,7 @@ class List(SecurableObject):
         """
         return self.properties.get("TemplateFeatureId", None)
 
-    @odata(name="TitleResource")
+    @odata(name="TitleResource", navigation=True)
     @property
     def title_resource(self) -> UserResource:
         """Represents the title of this list."""
@@ -1932,6 +2170,7 @@ class List(SecurableObject):
             UserResource(self.context, ResourcePath("TitleResource", self.resource_path)),
         )
 
+    @odata(name="ValidationFormula")
     @property
     def validation_formula(self) -> Optional[str]:
         """Specifies the data validation criteria for a list item."""
@@ -1944,3 +2183,1205 @@ class List(SecurableObject):
             if name == "Url":
                 self._resource_path = ServiceOperationPath("getList", [value], self.context.web.resource_path)
         return self
+
+    @odata(name="Color", beta=True)
+    @property
+    def color(self) -> Optional[str]:
+        """Gets the Color property"""
+        return self.properties.get("Color", None)
+
+    @odata(name="DefaultNewFormUrl")
+    @property
+    def default_new_form_url(self) -> Optional[str]:
+        """Gets the DefaultNewFormUrl property"""
+        return self.properties.get("DefaultNewFormUrl", None)
+
+    @odata(name="Direction", readonly=True)
+    @property
+    def direction(self) -> Optional[str]:
+        """Gets the Direction property"""
+        return self.properties.get("Direction", None)
+
+    @odata(name="DocumentReadSecurity", beta=True)
+    @property
+    def document_read_security(self) -> Optional[bool]:
+        """Gets the DocumentReadSecurity property"""
+        return self.properties.get("DocumentReadSecurity", None)
+
+    @odata(name="DraftVersionVisibility")
+    @property
+    def draft_version_visibility(self) -> Optional[int]:
+        """Gets the DraftVersionVisibility property"""
+        return self.properties.get("DraftVersionVisibility", None)
+
+    @odata(name="EnabledQueryableColumnsDateTime", readonly=True)
+    @property
+    def enabled_queryable_columns_datetime(self) -> Optional[datetime]:
+        """Gets the EnabledQueryableColumnsDateTime property"""
+        return self.properties.get("EnabledQueryableColumnsDateTime", datetime.min)
+
+    @odata(name="ExcludeFromOfflineMode")
+    @property
+    def exclude_from_offline_mode(self) -> Optional[bool]:
+        """Gets the ExcludeFromOfflineMode property"""
+        return self.properties.get("ExcludeFromOfflineMode", None)
+
+    @odata(name="ExtendedSharePointPermissionOfflineDaysForLibrary")
+    @property
+    def extended_sharepoint_permission_offline_days_for_library(self) -> Optional[int]:
+        """Gets the ExtendedSharePointPermissionOfflineDaysForLibrary property"""
+        return self.properties.get("ExtendedSharePointPermissionOfflineDaysForLibrary", None)
+
+    @odata(name="HasCopyMoveRules", readonly=True, beta=True)
+    @property
+    def has_copy_move_rules(self) -> Optional[bool]:
+        """Gets the HasCopyMoveRules property"""
+        return self.properties.get("HasCopyMoveRules", None)
+
+    @odata(name="HasListBoundContentAssemblyTemplates", beta=True)
+    @property
+    def has_list_bound_content_assembly_templates(self) -> Optional[bool]:
+        """Gets the HasListBoundContentAssemblyTemplates property"""
+        return self.properties.get("HasListBoundContentAssemblyTemplates", None)
+
+    @odata(name="HighPriorityMediaProcessing", readonly=True, beta=True)
+    @property
+    def high_priority_media_processing(self) -> Optional[bool]:
+        """Gets the HighPriorityMediaProcessing property"""
+        return self.properties.get("HighPriorityMediaProcessing", None)
+
+    @odata(name="Icon", beta=True)
+    @property
+    def icon(self) -> Optional[str]:
+        """Gets the Icon property"""
+        return self.properties.get("Icon", None)
+
+    @odata(name="ImagePath")
+    @property
+    def image_path(self) -> ResourcePath:
+        """Gets the ImagePath property"""
+        from office365.sharepoint.types.resource_path import ResourcePath
+
+        return self.properties.get("ImagePath", ResourcePath())
+
+    @odata(name="ImageUrl")
+    @property
+    def image_url(self) -> Optional[str]:
+        """Gets the ImageUrl property"""
+        return self.properties.get("ImageUrl", None)
+
+    @odata(name="DefaultSensitivityLabelForLibrary", readonly=True)
+    @property
+    def default_sensitivity_label_for_library(self) -> Optional[str]:
+        """Gets the DefaultSensitivityLabelForLibrary property"""
+        return self.properties.get("DefaultSensitivityLabelForLibrary", None)
+
+    @odata(name="SensitivityLabelToEncryptOnDownloadForLibrary")
+    @property
+    def sensitivity_label_to_encrypt_on_download_for_library(self) -> Optional[str]:
+        """Gets the SensitivityLabelToEncryptOnDownloadForLibrary property"""
+        return self.properties.get("SensitivityLabelToEncryptOnDownloadForLibrary", None)
+
+    @odata(name="IrmReject", readonly=True)
+    @property
+    def irm_reject(self) -> Optional[bool]:
+        """Gets the IrmReject property"""
+        return self.properties.get("IrmReject", None)
+
+    @odata(name="IsApplicationList")
+    @property
+    def is_application_list(self) -> Optional[bool]:
+        """Gets the IsApplicationList property"""
+        return self.properties.get("IsApplicationList", None)
+
+    @odata(name="IsCatalog", readonly=True)
+    @property
+    def is_catalog(self) -> Optional[bool]:
+        """Gets the IsCatalog property"""
+        return self.properties.get("IsCatalog", None)
+
+    @odata(name="IsContributorOwnerEnabled", readonly=True, beta=True)
+    @property
+    def is_contributor_owner_enabled(self) -> Optional[bool]:
+        """Gets the IsContributorOwnerEnabled property"""
+        return self.properties.get("IsContributorOwnerEnabled", None)
+
+    @odata(name="IsDefaultDocumentLibrary", readonly=True, beta=True)
+    @property
+    def is_default_document_library(self) -> Optional[bool]:
+        """Gets the IsDefaultDocumentLibrary property"""
+        return self.properties.get("IsDefaultDocumentLibrary", None)
+
+    @odata(name="IsEnterpriseGalleryLibrary", beta=True)
+    @property
+    def is_enterprise_gallery_library(self) -> Optional[bool]:
+        """Gets the IsEnterpriseGalleryLibrary property"""
+        return self.properties.get("IsEnterpriseGalleryLibrary", None)
+
+    @odata(name="IsPredictionModelApplied", readonly=True, beta=True)
+    @property
+    def is_prediction_model_applied(self) -> Optional[bool]:
+        """Gets the IsPredictionModelApplied property"""
+        return self.properties.get("IsPredictionModelApplied", None)
+
+    @odata(name="MultipleDataList")
+    @property
+    def multiple_data_list(self) -> Optional[bool]:
+        """Gets the MultipleDataList property"""
+        return self.properties.get("MultipleDataList", None)
+
+    @odata(name="ShowOneTabOnly")
+    @property
+    def show_one_tab_only(self) -> Optional[bool]:
+        """Gets the ShowOneTabOnly property"""
+        return self.properties.get("ShowOneTabOnly", None)
+
+    @odata(name="TemplateTypeId", beta=True)
+    @property
+    def template_type_id(self) -> Optional[str]:
+        """Gets the TemplateTypeId property"""
+        return self.properties.get("TemplateTypeId", None)
+
+    @odata(name="ValidationMessage")
+    @property
+    def validation_message(self) -> Optional[str]:
+        """Gets the ValidationMessage property"""
+        return self.properties.get("ValidationMessage", None)
+
+    @odata(name="WriteSecurity")
+    @property
+    def write_security(self) -> Optional[int]:
+        """Gets the WriteSecurity property"""
+        return self.properties.get("WriteSecurity", None)
+
+    @odata(name="ExtendedSharePointPermissionSettings", navigation=True)
+    @property
+    def extended_sharepoint_permission_settings(self) -> ExtendedSharePointPermissionSettings:
+        """Gets the ExtendedSharePointPermissionSettings property"""
+        from office365.sharepoint.lists.extended_share_point_permission_settings import (
+            ExtendedSharePointPermissionSettings,
+        )
+
+        return self.properties.get(
+            "ExtendedSharePointPermissionSettings",
+            ExtendedSharePointPermissionSettings(
+                self.context, ResourcePath("ExtendedSharePointPermissionSettings", self.resource_path)
+            ),
+        )
+
+    @odata(name="InformationRightsManagementSettings", navigation=True)
+    @property
+    def information_rights_management_settings(self) -> InformationRightsManagementSettings:
+        """Gets the InformationRightsManagementSettings property"""
+        from office365.sharepoint.permissions.irm.settings import (
+            InformationRightsManagementSettings,
+        )
+
+        return self.properties.get(
+            "InformationRightsManagementSettings",
+            InformationRightsManagementSettings(
+                self.context, ResourcePath("InformationRightsManagementSettings", self.resource_path)
+            ),
+        )
+
+    @odata(name="WorkflowAssociations", navigation=True)
+    @property
+    def workflow_associations(self) -> EntityCollection[WorkflowAssociation]:
+        """Gets the WorkflowAssociations property"""
+        from office365.sharepoint.workflow.associations.association import (
+            WorkflowAssociation,
+        )
+
+        return self.properties.get(
+            "WorkflowAssociations",
+            EntityCollection[WorkflowAssociation](
+                self.context, WorkflowAssociation, ResourcePath("WorkflowAssociations", self.resource_path)
+            ),
+        )
+
+    @site_access(SiteLevel.WRITE)
+    def add_validate_update_item_using_path(
+        self,
+        list_item_create_info: ListItemCreationInformationUsingPath,
+        form_values: ClientValueCollection[ListItemFormUpdateValue],
+        bnew_document_update: bool,
+        check_in_comment: str,
+        dates_in_utc: bool,
+        number_in_invariant_culture: bool,
+    ) -> ClientResult[ClientValueCollection[ListItemFormUpdateValue]]:
+        """AddValidateUpdateItemUsingPath operation.
+
+        Args:
+            list_item_create_info (ListItemCreationInformationUsingPath):
+                listItemCreateInfo parameter
+            form_values (ClientValueCollection[ListItemFormUpdateValue]):
+                formValues parameter
+            bnew_document_update (bool):
+                bNewDocumentUpdate parameter
+            check_in_comment (str):
+                checkInComment parameter
+            dates_in_utc (bool):
+                datesInUTC parameter
+            number_in_invariant_culture (bool):
+                numberInInvariantCulture parameter
+        """
+        from office365.sharepoint.listitems.form_update_value import (
+            ListItemFormUpdateValue,
+        )
+
+        return_type = ClientResult(self.context, ClientValueCollection[ListItemFormUpdateValue]())
+        qry = ServiceOperationQuery(
+            self,
+            "AddValidateUpdateItemUsingPath",
+            None,
+            {
+                "listItemCreateInfo": list_item_create_info,
+                "formValues": form_values,
+                "bNewDocumentUpdate": bnew_document_update,
+                "checkInComment": check_in_comment,
+                "datesInUTC": dates_in_utc,
+                "numberInInvariantCulture": number_in_invariant_culture,
+            },
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.WRITE)
+    def caae_create_temp_folder(self) -> ClientResult[str]:
+        """CAAECreateTempFolder operation."""
+        return_type = ClientResult(self.context, str())
+        qry = ServiceOperationQuery(self, "CAAECreateTempFolder", None, {}, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.WRITE)
+    def caae_rename_file_in_temporary_folder(self, path: str, updated_name: str) -> ClientResult[str]:
+        """CAAERenameFileInTemporaryFolder operation.
+
+        Args:
+            path (str):
+                Path parameter
+            updated_name (str):
+                UpdatedName parameter
+        """
+        return_type = ClientResult(self.context, str())
+        qry = ServiceOperationQuery(
+            self, "CAAERenameFileInTemporaryFolder", None, {"Path": path, "UpdatedName": updated_name}, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.WRITE)
+    def cancel_delete_file_versions(self) -> Self:
+        """CancelDeleteFileVersions operation."""
+        qry = ServiceOperationQuery(self, "CancelDeleteFileVersions", None, {}, None, None)
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.WRITE)
+    def clear_business_app_migration_interactive_data(self) -> Self:
+        """ClearBusinessAppMigrationInteractiveData operation."""
+        qry = ServiceOperationQuery(self, "ClearBusinessAppMigrationInteractiveData", None, {}, None, None)
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.WRITE)
+    def copy_template_and_get_metadata(self, id_: str) -> ClientResult[TemplatizationMetaData]:
+        """CopyTemplateAndGetMetadata operation.
+
+        Args:
+            id_ (str):
+                Id parameter
+        """
+        from office365.sharepoint.lists.templatization_metadata import (
+            TemplatizationMetaData,
+        )
+
+        return_type = ClientResult(self.context, TemplatizationMetaData())
+        qry = ServiceOperationQuery(self, "CopyTemplateAndGetMetadata", None, {"Id": id_}, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.WRITE)
+    def create_document_from_caae_template(
+        self, content_type_name: str, document_generation_info: DocumentGenerationInfo
+    ) -> ClientResult[ContentAssemblyFileInfo]:
+        """CreateDocumentFromCAAETemplate operation.
+
+        Args:
+            content_type_name (str):
+                ContentTypeName parameter
+            document_generation_info (DocumentGenerationInfo):
+                documentGenerationInfo parameter
+        """
+        from office365.sharepoint.documents.contentassemblyfileinfo import (
+            ContentAssemblyFileInfo,
+        )
+
+        return_type = ClientResult(self.context, ContentAssemblyFileInfo())
+        qry = ServiceOperationQuery(
+            self,
+            "CreateDocumentFromCAAETemplate",
+            None,
+            {"ContentTypeName": content_type_name, "documentGenerationInfo": document_generation_info},
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.WRITE)
+    def create_document_from_caae_template_v2(
+        self, id_: str, document_generation_info: DocumentGenerationInfo
+    ) -> ClientResult[ContentAssemblyFileInfo]:
+        """CreateDocumentFromCAAETemplateV2 operation.
+
+        Args:
+            id_ (str):
+                Id parameter
+            document_generation_info (DocumentGenerationInfo):
+                documentGenerationInfo parameter
+        """
+        from office365.sharepoint.documents.contentassemblyfileinfo import (
+            ContentAssemblyFileInfo,
+        )
+
+        return_type = ClientResult(self.context, ContentAssemblyFileInfo())
+        qry = ServiceOperationQuery(
+            self,
+            "CreateDocumentFromCAAETemplateV2",
+            None,
+            {"Id": id_, "documentGenerationInfo": document_generation_info},
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.WRITE)
+    def create_document_from_content_assembly_template(
+        self, template_url: str, document_generation_info: DocumentGenerationInfo
+    ) -> ClientResult[ContentAssemblyFileInfo]:
+        """CreateDocumentFromContentAssemblyTemplate operation.
+
+        Args:
+            template_url (str):
+                TemplateUrl parameter
+            document_generation_info (DocumentGenerationInfo):
+                documentGenerationInfo parameter
+        """
+        from office365.sharepoint.documents.contentassemblyfileinfo import (
+            ContentAssemblyFileInfo,
+        )
+
+        return_type = ClientResult(self.context, ContentAssemblyFileInfo())
+        qry = ServiceOperationQuery(
+            self,
+            "CreateDocumentFromContentAssemblyTemplate",
+            None,
+            {"TemplateUrl": template_url, "documentGenerationInfo": document_generation_info},
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.WRITE)
+    def create_hvcs_item_approval_request(
+        self, create_item_request_payload: CreateHVCSItemApprovalRequestParameters
+    ) -> ClientResult[str]:
+        """CreateHVCSItemApprovalRequest operation.
+
+        Args:
+            create_item_request_payload (CreateHVCSItemApprovalRequestParameters):
+                createItemRequestPayload parameter
+        """
+        return_type = ClientResult(self.context, str())
+        qry = ServiceOperationQuery(
+            self,
+            "CreateHVCSItemApprovalRequest",
+            None,
+            {"createItemRequestPayload": create_item_request_payload},
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.MANAGE)
+    def create_list_form(self, parameters: ListForm) -> ClientResult[ListForm]:
+        """CreateListForm operation.
+
+        Args:
+            parameters (ListForm):
+                parameters parameter
+        """
+        from office365.sharepoint.lists.listform import ListForm
+
+        return_type = ClientResult(self.context, ListForm())
+        qry = ServiceOperationQuery(self, "CreateListForm", None, {"parameters": parameters}, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.MANAGE)
+    def create_rule_ex(
+        self, condition: str, title: str, trigger_type: int, action: SPRuleAction, rule_template_id: str
+    ) -> ClientResult[UUID]:
+        """CreateRuleEx operation.
+
+        Args:
+            condition (str):
+                condition parameter
+            title (str):
+                title parameter
+            trigger_type (int):
+                triggerType parameter
+            action (SPRuleAction):
+                action parameter
+            rule_template_id (str):
+                ruleTemplateId parameter
+        """
+        return_type = ClientResult(self.context, UUID(int=0))
+        qry = ServiceOperationQuery(
+            self,
+            "CreateRuleEx",
+            None,
+            {
+                "condition": condition,
+                "title": title,
+                "triggerType": trigger_type,
+                "action": action,
+                "ruleTemplateId": rule_template_id,
+            },
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.MANAGE)
+    def enable_queryable_columns(self) -> Self:
+        """EnableQueryableColumns operation."""
+        qry = ServiceOperationQuery(self, "EnableQueryableColumns", None, {}, None, None)
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.READ)
+    def get_async_action_task_ids(self) -> ClientResult[GuidCollection]:
+        """GetAsyncActionTaskIds operation."""
+        return_type = ClientResult(self.context, GuidCollection())
+        qry = ServiceOperationQuery(self, "GetAsyncActionTaskIds", None, {}, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def get_business_app_migration_interactive_data(self) -> ClientResult[str]:
+        """GetBusinessAppMigrationInteractiveData operation."""
+        return_type = ClientResult(self.context, str())
+        qry = FunctionQuery(self, "GetBusinessAppMigrationInteractiveData", [], return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def get_caae_template_metadata(self, name: str, published: bool) -> ClientResult[TemplateMetaData]:
+        """GetCAAETemplateMetadata operation.
+
+        Args:
+            name (str):
+                Name parameter
+            published (bool):
+                Published parameter
+        """
+        from office365.sharepoint.documents.templatemetadata import TemplateMetaData
+
+        return_type = ClientResult(self.context, TemplateMetaData())
+        qry = FunctionQuery(self, "GetCAAETemplateMetadata", [name, published], return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def get_caae_template_metadata_v2(self, id_: str) -> ClientResult[ClientValueCollection[PlaceholderV2]]:
+        """GetCAAETemplateMetadataV2 operation.
+
+        Args:
+            id_ (str):
+                Id parameter
+        """
+        from office365.sharepoint.documents.placeholderv2 import PlaceholderV2
+
+        return_type = ClientResult(self.context, ClientValueCollection[PlaceholderV2]())
+        qry = FunctionQuery(self, "GetCAAETemplateMetadataV2", [id_], return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def get_content_assembly_document_field_values(self, document_url: str) -> ClientResult[FieldValuesWithUrl]:
+        """GetContentAssemblyDocumentFieldValues operation.
+
+        Args:
+            document_url (str):
+                DocumentUrl parameter
+        """
+        from office365.sharepoint.documents.fieldvalueswithurl import FieldValuesWithUrl
+
+        return_type = ClientResult(self.context, FieldValuesWithUrl())
+        qry = FunctionQuery(self, "GetContentAssemblyDocumentFieldValues", [document_url], return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def get_content_assembly_template_fields(
+        self, template_url: str
+    ) -> ClientResult[ClientValueCollection[PlaceholderV2]]:
+        """GetContentAssemblyTemplateFields operation.
+
+        Args:
+            template_url (str):
+                TemplateUrl parameter
+        """
+        from office365.sharepoint.documents.placeholderv2 import PlaceholderV2
+
+        return_type = ClientResult(self.context, ClientValueCollection[PlaceholderV2]())
+        qry = FunctionQuery(self, "GetContentAssemblyTemplateFields", [template_url], return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def get_list_forms(self, bsanitize: bool) -> ClientResult[ClientValueCollection[ListForm]]:
+        """GetListForms operation.
+
+        Args:
+            bsanitize (bool):
+                bSanitize parameter
+        """
+        from office365.sharepoint.lists.listform import ListForm
+
+        return_type = ClientResult(self.context, ClientValueCollection[ListForm]())
+        qry = FunctionQuery(self, "GetListForms", [bsanitize], return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def get_progress_for_delete_file_versions(self) -> ClientResult[str]:
+        """GetProgressForDeleteFileVersions operation."""
+        return_type = ClientResult(self.context, str())
+        qry = ServiceOperationQuery(self, "GetProgressForDeleteFileVersions", None, {}, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def get_progress_for_file_version_expiration_report(self, report_file_url: str) -> ClientResult[str]:
+        """GetProgressForFileVersionExpirationReport operation.
+
+        Args:
+            report_file_url (str):
+                reportFileUrl parameter
+        """
+        return_type = ClientResult(self.context, str())
+        qry = ServiceOperationQuery(
+            self,
+            "GetProgressForFileVersionExpirationReport",
+            None,
+            {"reportFileUrl": report_file_url},
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def is_syntex_ai_features_flight_enabled(self) -> ClientResult[bool]:
+        """IsSyntexAIFeaturesFlightEnabled operation."""
+        return_type = ClientResult(self.context, bool())
+        qry = FunctionQuery(self, "IsSyntexAIFeaturesFlightEnabled", [], return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.MANAGE)
+    def lock_smart_template(self, id_: str) -> ClientResult[LockFileData]:
+        """LockSmartTemplate operation.
+
+        Args:
+            id_ (str):
+                Id parameter
+        """
+        from office365.sharepoint.documents.lockfiledata import LockFileData
+
+        return_type = ClientResult(self.context, LockFileData())
+        qry = ServiceOperationQuery(self, "LockSmartTemplate", None, {"Id": id_}, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.MANAGE)
+    def map_fields_to_columns_for_modern_temlate(
+        self, payload: PublishModernTemplatePayload
+    ) -> ClientResult[ContentAssemblyModernTemplateColumnsMappingInfo]:
+        """MapFieldsToColumnsForModernTemlate operation.
+
+        Args:
+            payload (PublishModernTemplatePayload):
+                payload parameter
+        """
+        from office365.sharepoint.documents.contentassemblymoderntemplatecolumnsmappinginfo import (
+            ContentAssemblyModernTemplateColumnsMappingInfo,
+        )
+
+        return_type = ClientResult(self.context, ContentAssemblyModernTemplateColumnsMappingInfo())
+        qry = ServiceOperationQuery(
+            self, "MapFieldsToColumnsForModernTemlate", None, {"payload": payload}, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.MANAGE)
+    def map_fields_to_columns_for_modern_template(
+        self, template_payload: PublishModernTemplatePayload
+    ) -> ClientResult[ContentAssemblyModernTemplateColumnsMappingInfo]:
+        """MapFieldsToColumnsForModernTemplate operation.
+
+        Args:
+            template_payload (PublishModernTemplatePayload):
+                templatePayload parameter
+        """
+        from office365.sharepoint.documents.contentassemblymoderntemplatecolumnsmappinginfo import (
+            ContentAssemblyModernTemplateColumnsMappingInfo,
+        )
+
+        return_type = ClientResult(self.context, ContentAssemblyModernTemplateColumnsMappingInfo())
+        qry = ServiceOperationQuery(
+            self, "MapFieldsToColumnsForModernTemplate", None, {"templatePayload": template_payload}, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def parse_document_template(self, name: str) -> ClientResult[str]:
+        """ParseDocumentTemplate operation.
+
+        Args:
+            name (str):
+                Name parameter
+        """
+        return_type = ClientResult(self.context, str())
+        qry = ServiceOperationQuery(self, "ParseDocumentTemplate", None, {"Name": name}, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.MANAGE)
+    def publish_snippet(self, publish_snippet_payload: PublishSnippetPayload) -> Self:
+        """PublishSnippet operation.
+
+        Args:
+            publish_snippet_payload (PublishSnippetPayload):
+                publishSnippetPayload parameter
+        """
+        qry = ServiceOperationQuery(
+            self, "PublishSnippet", None, {"publishSnippetPayload": publish_snippet_payload}, None, None
+        )
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.MANAGE)
+    def publish_template_v2(self, payload: PublishTemplateV2Payload) -> Self:
+        """PublishTemplateV2 operation.
+
+        Args:
+            payload (PublishTemplateV2Payload):
+                payload parameter
+        """
+        qry = ServiceOperationQuery(self, "PublishTemplateV2", None, {"payload": payload}, None, None)
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.MANAGE)
+    def refresh_lock_smart_template(self, id_: str, lock_id: str) -> ClientResult[LockFileData]:
+        """RefreshLockSmartTemplate operation.
+
+        Args:
+            id_ (str):
+                Id parameter
+            lock_id (str):
+                LockId parameter
+        """
+        from office365.sharepoint.documents.lockfiledata import LockFileData
+
+        return_type = ClientResult(self.context, LockFileData())
+        qry = ServiceOperationQuery(
+            self, "RefreshLockSmartTemplate", None, {"Id": id_, "LockId": lock_id}, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def render_extended_list_form_data(
+        self, item_id: int, form_id: str, mode: int, options: int, cutoff_version: int
+    ) -> ClientResult[str]:
+        """RenderExtendedListFormData operation.
+
+        Args:
+            item_id (int):
+                itemId parameter
+            form_id (str):
+                formId parameter
+            mode (int):
+                mode parameter
+            options (int):
+                options parameter
+            cutoff_version (int):
+                cutoffVersion parameter
+        """
+        return_type = ClientResult(self.context, str())
+        qry = ServiceOperationQuery(
+            self,
+            "RenderExtendedListFormData",
+            None,
+            {"itemId": item_id, "formId": form_id, "mode": mode, "options": options, "cutoffVersion": cutoff_version},
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def render_list_context_menu_data(
+        self,
+        casc_del_warn_message: str,
+        custom_action: str,
+        field: str,
+        id_: str,
+        inplace_full_list_search: str,
+        inplace_search_query: str,
+        is_csr: str,
+        is_xsl_view: str,
+        item_id: str,
+        list_view_page_url: str,
+        override_scope: str,
+        root_folder: str,
+        view: str,
+        view_count: str,
+    ) -> ClientResult[bytes]:
+        """RenderListContextMenuData operation.
+
+        Args:
+            casc_del_warn_message (str):
+                CascDelWarnMessage parameter
+            custom_action (str):
+                CustomAction parameter
+            field (str):
+                Field parameter
+            id_ (str):
+                ID parameter
+            inplace_full_list_search (str):
+                InplaceFullListSearch parameter
+            inplace_search_query (str):
+                InplaceSearchQuery parameter
+            is_csr (str):
+                IsCSR parameter
+            is_xsl_view (str):
+                IsXslView parameter
+            item_id (str):
+                ItemId parameter
+            list_view_page_url (str):
+                ListViewPageUrl parameter
+            override_scope (str):
+                OverrideScope parameter
+            root_folder (str):
+                RootFolder parameter
+            view (str):
+                View parameter
+            view_count (str):
+                ViewCount parameter
+        """
+        return_type = ClientResult(self.context, bytes())
+        qry = ServiceOperationQuery(
+            self,
+            "RenderListContextMenuData",
+            None,
+            {
+                "CascDelWarnMessage": casc_del_warn_message,
+                "CustomAction": custom_action,
+                "Field": field,
+                "ID": id_,
+                "InplaceFullListSearch": inplace_full_list_search,
+                "InplaceSearchQuery": inplace_search_query,
+                "IsCSR": is_csr,
+                "IsXslView": is_xsl_view,
+                "ItemId": item_id,
+                "ListViewPageUrl": list_view_page_url,
+                "OverrideScope": override_scope,
+                "RootFolder": root_folder,
+                "View": view,
+                "ViewCount": view_count,
+            },
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def render_list_filter_data(
+        self,
+        exclude_field_filtering_html: bool,
+        field_internal_name: str,
+        override_scope: str,
+        process_q_string_to_caml: str,
+        view_id: str,
+        view_xml: str,
+    ) -> ClientResult[bytes]:
+        """RenderListFilterData operation.
+
+        Args:
+            exclude_field_filtering_html (bool):
+                ExcludeFieldFilteringHtml parameter
+            field_internal_name (str):
+                FieldInternalName parameter
+            override_scope (str):
+                OverrideScope parameter
+            process_q_string_to_caml (str):
+                ProcessQStringToCAML parameter
+            view_id (str):
+                ViewId parameter
+            view_xml (str):
+                ViewXml parameter
+        """
+        return_type = ClientResult(self.context, bytes())
+        qry = ServiceOperationQuery(
+            self,
+            "RenderListFilterData",
+            None,
+            {
+                "ExcludeFieldFilteringHtml": exclude_field_filtering_html,
+                "FieldInternalName": field_internal_name,
+                "OverrideScope": override_scope,
+                "ProcessQStringToCAML": process_q_string_to_caml,
+                "ViewId": view_id,
+                "ViewXml": view_xml,
+            },
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.READ)
+    def render_list_form_data(self, item_id: int, form_id: str, mode: int) -> ClientResult[str]:
+        """RenderListFormData operation.
+
+        Args:
+            item_id (int):
+                itemId parameter
+            form_id (str):
+                formId parameter
+            mode (int):
+                mode parameter
+        """
+        return_type = ClientResult(self.context, str())
+        qry = ServiceOperationQuery(
+            self, "RenderListFormData", None, {"itemId": item_id, "formId": form_id, "mode": mode}, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.MANAGE)
+    def set_column_mapping(self, column_mapping: str) -> Self:
+        """SetColumnMapping operation.
+
+        Args:
+            column_mapping (str):
+                columnMapping parameter
+        """
+        qry = ServiceOperationQuery(self, "SetColumnMapping", None, {"columnMapping": column_mapping}, None, None)
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.MANAGE)
+    def set_content_assembly_template_read_only(self, id_: str) -> Self:
+        """SetContentAssemblyTemplateReadOnly operation.
+
+        Args:
+            id_ (str):
+                Id parameter
+        """
+        qry = ServiceOperationQuery(self, "SetContentAssemblyTemplateReadOnly", None, {"Id": id_}, None, None)
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.MANAGE)
+    def set_items_order(
+        self, item_ids: list[int], lower_order_item_id: int, higher_order_item_id: int, use_provided_order_item_id: bool
+    ) -> ClientResult[ClientValueCollection[ItemOrderUpdateValue]]:
+        """SetItemsOrder operation.
+
+        Args:
+            item_ids (list[int]):
+                itemIds parameter
+            lower_order_item_id (int):
+                lowerOrderItemId parameter
+            higher_order_item_id (int):
+                higherOrderItemId parameter
+            use_provided_order_item_id (bool):
+                useProvidedOrderItemId parameter
+        """
+        from office365.sharepoint.documents.itemorderupdatevalue import (
+            ItemOrderUpdateValue,
+        )
+
+        return_type = ClientResult(self.context, ClientValueCollection[ItemOrderUpdateValue]())
+        qry = ServiceOperationQuery(
+            self,
+            "SetItemsOrder",
+            None,
+            {
+                "itemIds": ClientValueCollection(int, item_ids),
+                "lowerOrderItemId": lower_order_item_id,
+                "higherOrderItemId": higher_order_item_id,
+                "useProvidedOrderItemId": use_provided_order_item_id,
+            },
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.MANAGE)
+    def set_list_custom_order_flag(self, value: bool) -> Self:
+        """SetListCustomOrderFlag operation.
+
+        Args:
+            value (bool):
+                value parameter
+        """
+        qry = ServiceOperationQuery(self, "SetListCustomOrderFlag", None, {"value": value}, None, None)
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.MANAGE)
+    def set_quickstep_ordering(self, quickstep_ids: str) -> Self:
+        """SetQuickstepOrdering operation.
+
+        Args:
+            quickstep_ids (str):
+                quickstepIds parameter
+        """
+        qry = ServiceOperationQuery(self, "SetQuickstepOrdering", None, {"quickstepIds": quickstep_ids}, None, None)
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.WRITE)
+    def start_delete_file_versions(self, delete_older_than_days: int) -> Self:
+        """StartDeleteFileVersions operation.
+
+        Args:
+            delete_older_than_days (int):
+                deleteOlderThanDays parameter
+        """
+        qry = ServiceOperationQuery(
+            self, "StartDeleteFileVersions", None, {"deleteOlderThanDays": delete_older_than_days}, None, None
+        )
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.WRITE)
+    def start_delete_file_versions_by_mode(self, batch_delete_parameters: FileVersionBatchDeleteParameters) -> Self:
+        """StartDeleteFileVersionsByMode operation.
+
+        Args:
+            batch_delete_parameters (FileVersionBatchDeleteParameters):
+                batchDeleteParameters parameter
+        """
+        qry = ServiceOperationQuery(
+            self, "StartDeleteFileVersionsByMode", None, {"batchDeleteParameters": batch_delete_parameters}, None, None
+        )
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.WRITE)
+    def start_file_version_expiration_report(self, report_file_url: str) -> Self:
+        """StartFileVersionExpirationReport operation.
+
+        Args:
+            report_file_url (str):
+                reportFileUrl parameter
+        """
+        qry = ServiceOperationQuery(
+            self, "StartFileVersionExpirationReport", None, {"reportFileUrl": report_file_url}, None, None
+        )
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.MANAGE)
+    def unlock_smart_template(self, id_: str, lock_id: str) -> Self:
+        """UnlockSmartTemplate operation.
+
+        Args:
+            id_ (str):
+                Id parameter
+            lock_id (str):
+                LockId parameter
+        """
+        qry = ServiceOperationQuery(self, "UnlockSmartTemplate", None, {"Id": id_, "LockId": lock_id}, None, None)
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.MANAGE)
+    def unset_content_assembly_template_read_only(self, id_: str) -> Self:
+        """UnsetContentAssemblyTemplateReadOnly operation.
+
+        Args:
+            id_ (str):
+                Id parameter
+        """
+        qry = ServiceOperationQuery(self, "UnsetContentAssemblyTemplateReadOnly", None, {"Id": id_}, None, None)
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.WRITE)
+    def update_caae_template(self, name: str, update_template_info: UpdateTemplateInfo) -> Self:
+        """UpdateCAAETemplate operation.
+
+        Args:
+            name (str):
+                Name parameter
+            update_template_info (UpdateTemplateInfo):
+                updateTemplateInfo parameter
+        """
+        qry = ServiceOperationQuery(
+            self, "UpdateCAAETemplate", None, {"Name": name, "updateTemplateInfo": update_template_info}, None, None
+        )
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.WRITE)
+    def update_caae_template_v2(self, id_: str, update_template_info: UpdateTemplateInfoV2) -> Self:
+        """UpdateCAAETemplateV2 operation.
+
+        Args:
+            id_ (str):
+                Id parameter
+            update_template_info (UpdateTemplateInfoV2):
+                updateTemplateInfo parameter
+        """
+        qry = ServiceOperationQuery(
+            self, "UpdateCAAETemplateV2", None, {"Id": id_, "updateTemplateInfo": update_template_info}, None, None
+        )
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.WRITE)
+    def update_content_assembly_document(
+        self, template_url: str, content_assembly_form_answers: ClientValueCollection[ContentAssemblyFormAnswer]
+    ) -> ClientResult[ContentAssemblyFileInfo]:
+        """UpdateContentAssemblyDocument operation.
+
+        Args:
+            template_url (str):
+                TemplateUrl parameter
+            content_assembly_form_answers (ClientValueCollection[ContentAssemblyFormAnswer]):
+                contentAssemblyFormAnswers parameter
+        """
+        from office365.sharepoint.documents.contentassemblyfileinfo import (
+            ContentAssemblyFileInfo,
+        )
+
+        return_type = ClientResult(self.context, ContentAssemblyFileInfo())
+        qry = ServiceOperationQuery(
+            self,
+            "UpdateContentAssemblyDocument",
+            None,
+            {"TemplateUrl": template_url, "contentAssemblyFormAnswers": content_assembly_form_answers},
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.MANAGE)
+    def update_form_processing_model_retention_label(self, retention_label: str) -> Self:
+        """UpdateFormProcessingModelRetentionLabel operation.
+
+        Args:
+            retention_label (str):
+                retentionLabel parameter
+        """
+        qry = ServiceOperationQuery(
+            self, "UpdateFormProcessingModelRetentionLabel", None, {"retentionLabel": retention_label}, None, None
+        )
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.MANAGE)
+    def update_form_processing_model_settings(self, retention_label: str, linked_list: str) -> Self:
+        """UpdateFormProcessingModelSettings operation.
+
+        Args:
+            retention_label (str):
+                retentionLabel parameter
+            linked_list (str):
+                linkedList parameter
+        """
+        qry = ServiceOperationQuery(
+            self,
+            "UpdateFormProcessingModelSettings",
+            None,
+            {"retentionLabel": retention_label, "linkedList": linked_list},
+            None,
+            None,
+        )
+        self.context.add_query(qry)
+        return self
+
+    @site_access(SiteLevel.MANAGE)
+    def update_list_form(self, parameters: ListForm) -> ClientResult[ListForm]:
+        """UpdateListForm operation.
+
+        Args:
+            parameters (ListForm):
+                parameters parameter
+        """
+        from office365.sharepoint.lists.listform import ListForm
+
+        return_type = ClientResult(self.context, ListForm())
+        qry = ServiceOperationQuery(self, "UpdateListForm", None, {"parameters": parameters}, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @site_access(SiteLevel.MANAGE)
+    def update_rule_ex(
+        self, rule_id: str, condition: str, title: str, status: int, action: SPRuleAction, trigger_type: int
+    ) -> Self:
+        """UpdateRuleEx operation.
+
+        Args:
+            rule_id (str):
+                ruleId parameter
+            condition (str):
+                condition parameter
+            title (str):
+                title parameter
+            status (int):
+                status parameter
+            action (SPRuleAction):
+                action parameter
+            trigger_type (int):
+                triggerType parameter
+        """
+        qry = ServiceOperationQuery(
+            self,
+            "UpdateRuleEx",
+            None,
+            {
+                "ruleId": rule_id,
+                "condition": condition,
+                "title": title,
+                "status": status,
+                "action": action,
+                "triggerType": trigger_type,
+            },
+            None,
+            None,
+        )
+        self.context.add_query(qry)
+        return self