mergepythonclient 2.4.0__py3-none-any.whl → 2.5.0__py3-none-any.whl

merge/resources/ticketing/resources/attachments/client.py

@@ -82,7 +82,7 @@ class AttachmentsClient:
             If provided, only objects synced by Merge before this date time will be returned.
 
         page_size : typing.Optional[int]
-            Number of results to return per page.
+            Number of results to return per page. The maximum limit is 100.
 
         remote_created_after : typing.Optional[dt.datetime]
             If provided, will only return attachments created in the third party platform after this datetime.
@@ -103,6 +103,8 @@ class AttachmentsClient:
 
         Examples
         --------
+        import datetime
+
         from merge import Merge
 
         client = Merge(
@@ -110,7 +112,28 @@ class AttachmentsClient:
             api_key="YOUR_API_KEY",
         )
         client.ticketing.attachments.list(
+            created_after=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            created_before=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
             cursor="cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
+            include_deleted_data=True,
+            include_remote_data=True,
+            include_shell_data=True,
+            modified_after=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            modified_before=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            page_size=1,
+            remote_created_after=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            remote_id="remote_id",
+            ticket_id="ticket_id",
         )
         """
         _response = self._raw_client.list(
@@ -170,6 +193,8 @@ class AttachmentsClient:
             api_key="YOUR_API_KEY",
         )
         client.ticketing.attachments.create(
+            is_debug_mode=True,
+            run_async=True,
             model=AttachmentRequest(),
         )
         """
@@ -221,6 +246,8 @@ class AttachmentsClient:
         )
         client.ticketing.attachments.retrieve(
             id="id",
+            include_remote_data=True,
+            include_shell_data=True,
         )
         """
         _response = self._raw_client.retrieve(
@@ -360,7 +387,7 @@ class AsyncAttachmentsClient:
             If provided, only objects synced by Merge before this date time will be returned.
 
         page_size : typing.Optional[int]
-            Number of results to return per page.
+            Number of results to return per page. The maximum limit is 100.
 
         remote_created_after : typing.Optional[dt.datetime]
             If provided, will only return attachments created in the third party platform after this datetime.
@@ -382,6 +409,7 @@ class AsyncAttachmentsClient:
         Examples
         --------
         import asyncio
+        import datetime
 
         from merge import AsyncMerge
 
@@ -393,7 +421,28 @@ class AsyncAttachmentsClient:
 
         async def main() -> None:
             await client.ticketing.attachments.list(
+                created_after=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
+                created_before=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
                 cursor="cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
+                include_deleted_data=True,
+                include_remote_data=True,
+                include_shell_data=True,
+                modified_after=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
+                modified_before=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
+                page_size=1,
+                remote_created_after=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
+                remote_id="remote_id",
+                ticket_id="ticket_id",
             )
 
 
@@ -461,6 +510,8 @@ class AsyncAttachmentsClient:
 
         async def main() -> None:
             await client.ticketing.attachments.create(
+                is_debug_mode=True,
+                run_async=True,
                 model=AttachmentRequest(),
             )
 
@@ -520,6 +571,8 @@ class AsyncAttachmentsClient:
         async def main() -> None:
             await client.ticketing.attachments.retrieve(
                 id="id",
+                include_remote_data=True,
+                include_shell_data=True,
             )
 
 

merge/resources/ticketing/resources/attachments/raw_client.py

@@ -77,7 +77,7 @@ class RawAttachmentsClient:
             If provided, only objects synced by Merge before this date time will be returned.
 
         page_size : typing.Optional[int]
-            Number of results to return per page.
+            Number of results to return per page. The maximum limit is 100.
 
         remote_created_after : typing.Optional[dt.datetime]
             If provided, will only return attachments created in the third party platform after this datetime.
@@ -400,7 +400,7 @@ class AsyncRawAttachmentsClient:
             If provided, only objects synced by Merge before this date time will be returned.
 
         page_size : typing.Optional[int]
-            Number of results to return per page.
+            Number of results to return per page. The maximum limit is 100.
 
         remote_created_after : typing.Optional[dt.datetime]
             If provided, will only return attachments created in the third party platform after this datetime.

merge/resources/ticketing/resources/audit_trail/client.py

@@ -49,7 +49,7 @@ class AuditTrailClient:
             If included, will only include events with the given event type. Possible values include: `CREATED_REMOTE_PRODUCTION_API_KEY`, `DELETED_REMOTE_PRODUCTION_API_KEY`, `CREATED_TEST_API_KEY`, `DELETED_TEST_API_KEY`, `REGENERATED_PRODUCTION_API_KEY`, `REGENERATED_WEBHOOK_SIGNATURE`, `INVITED_USER`, `TWO_FACTOR_AUTH_ENABLED`, `TWO_FACTOR_AUTH_DISABLED`, `DELETED_LINKED_ACCOUNT`, `DELETED_ALL_COMMON_MODELS_FOR_LINKED_ACCOUNT`, `CREATED_DESTINATION`, `DELETED_DESTINATION`, `CHANGED_DESTINATION`, `CHANGED_SCOPES`, `CHANGED_PERSONAL_INFORMATION`, `CHANGED_ORGANIZATION_SETTINGS`, `ENABLED_INTEGRATION`, `DISABLED_INTEGRATION`, `ENABLED_CATEGORY`, `DISABLED_CATEGORY`, `CHANGED_PASSWORD`, `RESET_PASSWORD`, `ENABLED_REDACT_UNMAPPED_DATA_FOR_ORGANIZATION`, `ENABLED_REDACT_UNMAPPED_DATA_FOR_LINKED_ACCOUNT`, `DISABLED_REDACT_UNMAPPED_DATA_FOR_ORGANIZATION`, `DISABLED_REDACT_UNMAPPED_DATA_FOR_LINKED_ACCOUNT`, `CREATED_INTEGRATION_WIDE_FIELD_MAPPING`, `CREATED_LINKED_ACCOUNT_FIELD_MAPPING`, `CHANGED_INTEGRATION_WIDE_FIELD_MAPPING`, `CHANGED_LINKED_ACCOUNT_FIELD_MAPPING`, `DELETED_INTEGRATION_WIDE_FIELD_MAPPING`, `DELETED_LINKED_ACCOUNT_FIELD_MAPPING`, `CREATED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `CHANGED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `DELETED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `FORCED_LINKED_ACCOUNT_RESYNC`, `MUTED_ISSUE`, `GENERATED_MAGIC_LINK`, `ENABLED_MERGE_WEBHOOK`, `DISABLED_MERGE_WEBHOOK`, `MERGE_WEBHOOK_TARGET_CHANGED`, `END_USER_CREDENTIALS_ACCESSED`
 
         page_size : typing.Optional[int]
-            Number of results to return per page.
+            Number of results to return per page. The maximum limit is 100.
 
         start_date : typing.Optional[str]
             If included, will only include audit trail events that occurred after this time
@@ -75,6 +75,11 @@ class AuditTrailClient:
         )
         client.ticketing.audit_trail.list(
             cursor="cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
+            end_date="end_date",
+            event_type="event_type",
+            page_size=1,
+            start_date="start_date",
+            user_email="user_email",
         )
         """
         _response = self._raw_client.list(
@@ -130,7 +135,7 @@ class AsyncAuditTrailClient:
             If included, will only include events with the given event type. Possible values include: `CREATED_REMOTE_PRODUCTION_API_KEY`, `DELETED_REMOTE_PRODUCTION_API_KEY`, `CREATED_TEST_API_KEY`, `DELETED_TEST_API_KEY`, `REGENERATED_PRODUCTION_API_KEY`, `REGENERATED_WEBHOOK_SIGNATURE`, `INVITED_USER`, `TWO_FACTOR_AUTH_ENABLED`, `TWO_FACTOR_AUTH_DISABLED`, `DELETED_LINKED_ACCOUNT`, `DELETED_ALL_COMMON_MODELS_FOR_LINKED_ACCOUNT`, `CREATED_DESTINATION`, `DELETED_DESTINATION`, `CHANGED_DESTINATION`, `CHANGED_SCOPES`, `CHANGED_PERSONAL_INFORMATION`, `CHANGED_ORGANIZATION_SETTINGS`, `ENABLED_INTEGRATION`, `DISABLED_INTEGRATION`, `ENABLED_CATEGORY`, `DISABLED_CATEGORY`, `CHANGED_PASSWORD`, `RESET_PASSWORD`, `ENABLED_REDACT_UNMAPPED_DATA_FOR_ORGANIZATION`, `ENABLED_REDACT_UNMAPPED_DATA_FOR_LINKED_ACCOUNT`, `DISABLED_REDACT_UNMAPPED_DATA_FOR_ORGANIZATION`, `DISABLED_REDACT_UNMAPPED_DATA_FOR_LINKED_ACCOUNT`, `CREATED_INTEGRATION_WIDE_FIELD_MAPPING`, `CREATED_LINKED_ACCOUNT_FIELD_MAPPING`, `CHANGED_INTEGRATION_WIDE_FIELD_MAPPING`, `CHANGED_LINKED_ACCOUNT_FIELD_MAPPING`, `DELETED_INTEGRATION_WIDE_FIELD_MAPPING`, `DELETED_LINKED_ACCOUNT_FIELD_MAPPING`, `CREATED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `CHANGED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `DELETED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `FORCED_LINKED_ACCOUNT_RESYNC`, `MUTED_ISSUE`, `GENERATED_MAGIC_LINK`, `ENABLED_MERGE_WEBHOOK`, `DISABLED_MERGE_WEBHOOK`, `MERGE_WEBHOOK_TARGET_CHANGED`, `END_USER_CREDENTIALS_ACCESSED`
 
         page_size : typing.Optional[int]
-            Number of results to return per page.
+            Number of results to return per page. The maximum limit is 100.
 
         start_date : typing.Optional[str]
             If included, will only include audit trail events that occurred after this time
@@ -161,6 +166,11 @@ class AsyncAuditTrailClient:
         async def main() -> None:
             await client.ticketing.audit_trail.list(
                 cursor="cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
+                end_date="end_date",
+                event_type="event_type",
+                page_size=1,
+                start_date="start_date",
+                user_email="user_email",
             )
 
 

merge/resources/ticketing/resources/audit_trail/raw_client.py

@@ -41,7 +41,7 @@ class RawAuditTrailClient:
             If included, will only include events with the given event type. Possible values include: `CREATED_REMOTE_PRODUCTION_API_KEY`, `DELETED_REMOTE_PRODUCTION_API_KEY`, `CREATED_TEST_API_KEY`, `DELETED_TEST_API_KEY`, `REGENERATED_PRODUCTION_API_KEY`, `REGENERATED_WEBHOOK_SIGNATURE`, `INVITED_USER`, `TWO_FACTOR_AUTH_ENABLED`, `TWO_FACTOR_AUTH_DISABLED`, `DELETED_LINKED_ACCOUNT`, `DELETED_ALL_COMMON_MODELS_FOR_LINKED_ACCOUNT`, `CREATED_DESTINATION`, `DELETED_DESTINATION`, `CHANGED_DESTINATION`, `CHANGED_SCOPES`, `CHANGED_PERSONAL_INFORMATION`, `CHANGED_ORGANIZATION_SETTINGS`, `ENABLED_INTEGRATION`, `DISABLED_INTEGRATION`, `ENABLED_CATEGORY`, `DISABLED_CATEGORY`, `CHANGED_PASSWORD`, `RESET_PASSWORD`, `ENABLED_REDACT_UNMAPPED_DATA_FOR_ORGANIZATION`, `ENABLED_REDACT_UNMAPPED_DATA_FOR_LINKED_ACCOUNT`, `DISABLED_REDACT_UNMAPPED_DATA_FOR_ORGANIZATION`, `DISABLED_REDACT_UNMAPPED_DATA_FOR_LINKED_ACCOUNT`, `CREATED_INTEGRATION_WIDE_FIELD_MAPPING`, `CREATED_LINKED_ACCOUNT_FIELD_MAPPING`, `CHANGED_INTEGRATION_WIDE_FIELD_MAPPING`, `CHANGED_LINKED_ACCOUNT_FIELD_MAPPING`, `DELETED_INTEGRATION_WIDE_FIELD_MAPPING`, `DELETED_LINKED_ACCOUNT_FIELD_MAPPING`, `CREATED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `CHANGED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `DELETED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `FORCED_LINKED_ACCOUNT_RESYNC`, `MUTED_ISSUE`, `GENERATED_MAGIC_LINK`, `ENABLED_MERGE_WEBHOOK`, `DISABLED_MERGE_WEBHOOK`, `MERGE_WEBHOOK_TARGET_CHANGED`, `END_USER_CREDENTIALS_ACCESSED`
 
         page_size : typing.Optional[int]
-            Number of results to return per page.
+            Number of results to return per page. The maximum limit is 100.
 
         start_date : typing.Optional[str]
             If included, will only include audit trail events that occurred after this time
@@ -116,7 +116,7 @@ class AsyncRawAuditTrailClient:
             If included, will only include events with the given event type. Possible values include: `CREATED_REMOTE_PRODUCTION_API_KEY`, `DELETED_REMOTE_PRODUCTION_API_KEY`, `CREATED_TEST_API_KEY`, `DELETED_TEST_API_KEY`, `REGENERATED_PRODUCTION_API_KEY`, `REGENERATED_WEBHOOK_SIGNATURE`, `INVITED_USER`, `TWO_FACTOR_AUTH_ENABLED`, `TWO_FACTOR_AUTH_DISABLED`, `DELETED_LINKED_ACCOUNT`, `DELETED_ALL_COMMON_MODELS_FOR_LINKED_ACCOUNT`, `CREATED_DESTINATION`, `DELETED_DESTINATION`, `CHANGED_DESTINATION`, `CHANGED_SCOPES`, `CHANGED_PERSONAL_INFORMATION`, `CHANGED_ORGANIZATION_SETTINGS`, `ENABLED_INTEGRATION`, `DISABLED_INTEGRATION`, `ENABLED_CATEGORY`, `DISABLED_CATEGORY`, `CHANGED_PASSWORD`, `RESET_PASSWORD`, `ENABLED_REDACT_UNMAPPED_DATA_FOR_ORGANIZATION`, `ENABLED_REDACT_UNMAPPED_DATA_FOR_LINKED_ACCOUNT`, `DISABLED_REDACT_UNMAPPED_DATA_FOR_ORGANIZATION`, `DISABLED_REDACT_UNMAPPED_DATA_FOR_LINKED_ACCOUNT`, `CREATED_INTEGRATION_WIDE_FIELD_MAPPING`, `CREATED_LINKED_ACCOUNT_FIELD_MAPPING`, `CHANGED_INTEGRATION_WIDE_FIELD_MAPPING`, `CHANGED_LINKED_ACCOUNT_FIELD_MAPPING`, `DELETED_INTEGRATION_WIDE_FIELD_MAPPING`, `DELETED_LINKED_ACCOUNT_FIELD_MAPPING`, `CREATED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `CHANGED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `DELETED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `FORCED_LINKED_ACCOUNT_RESYNC`, `MUTED_ISSUE`, `GENERATED_MAGIC_LINK`, `ENABLED_MERGE_WEBHOOK`, `DISABLED_MERGE_WEBHOOK`, `MERGE_WEBHOOK_TARGET_CHANGED`, `END_USER_CREDENTIALS_ACCESSED`
 
         page_size : typing.Optional[int]
-            Number of results to return per page.
+            Number of results to return per page. The maximum limit is 100.
 
         start_date : typing.Optional[str]
             If included, will only include audit trail events that occurred after this time

merge/resources/ticketing/resources/collections/__init__.py

@@ -6,8 +6,11 @@ import typing
 from importlib import import_module
 
 if typing.TYPE_CHECKING:
-    from .types import CollectionsViewersListRequestExpand
-_dynamic_imports: typing.Dict[str, str] = {"CollectionsViewersListRequestExpand": ".types"}
+    from .types import CollectionsListRequestCollectionType, CollectionsViewersListRequestExpand
+_dynamic_imports: typing.Dict[str, str] = {
+    "CollectionsListRequestCollectionType": ".types",
+    "CollectionsViewersListRequestExpand": ".types",
+}
 
 
 def __getattr__(attr_name: str) -> typing.Any:
@@ -29,4 +32,4 @@ def __dir__():
     return sorted(lazy_attrs)
 
 
-__all__ = ["CollectionsViewersListRequestExpand"]
+__all__ = ["CollectionsListRequestCollectionType", "CollectionsViewersListRequestExpand"]

merge/resources/ticketing/resources/collections/client.py

@@ -9,6 +9,7 @@ from ...types.collection import Collection
 from ...types.paginated_collection_list import PaginatedCollectionList
 from ...types.paginated_viewer_list import PaginatedViewerList
 from .raw_client import AsyncRawCollectionsClient, RawCollectionsClient
+from .types.collections_list_request_collection_type import CollectionsListRequestCollectionType
 from .types.collections_viewers_list_request_expand import CollectionsViewersListRequestExpand
 
 
@@ -30,7 +31,7 @@ class CollectionsClient:
     def list(
         self,
         *,
-        collection_type: typing.Optional[str] = None,
+        collection_type: typing.Optional[CollectionsListRequestCollectionType] = None,
         created_after: typing.Optional[dt.datetime] = None,
         created_before: typing.Optional[dt.datetime] = None,
         cursor: typing.Optional[str] = None,
@@ -53,7 +54,7 @@ class CollectionsClient:
 
         Parameters
         ----------
-        collection_type : typing.Optional[str]
+        collection_type : typing.Optional[CollectionsListRequestCollectionType]
             If provided, will only return collections of the given type.
 
         created_after : typing.Optional[dt.datetime]
@@ -87,7 +88,7 @@ class CollectionsClient:
             If provided, will only return collections with this name.
 
         page_size : typing.Optional[int]
-            Number of results to return per page.
+            Number of results to return per page. The maximum limit is 100.
 
         parent_collection_id : typing.Optional[str]
             If provided, will only return collections whose parent collection matches the given id.
@@ -111,14 +112,39 @@ class CollectionsClient:
 
         Examples
         --------
+        import datetime
+
         from merge import Merge
+        from merge.resources.ticketing.resources.collections import (
+            CollectionsListRequestCollectionType,
+        )
 
         client = Merge(
             account_token="YOUR_ACCOUNT_TOKEN",
             api_key="YOUR_API_KEY",
         )
         client.ticketing.collections.list(
+            collection_type=CollectionsListRequestCollectionType.EMPTY,
+            created_after=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            created_before=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
             cursor="cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
+            include_deleted_data=True,
+            include_remote_data=True,
+            include_shell_data=True,
+            modified_after=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            modified_before=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            name="name",
+            page_size=1,
+            parent_collection_id="parent_collection_id",
+            remote_id="remote_id",
         )
         """
         _response = self._raw_client.list(
@@ -190,6 +216,9 @@ class CollectionsClient:
         Examples
         --------
         from merge import Merge
+        from merge.resources.ticketing.resources.collections import (
+            CollectionsViewersListRequestExpand,
+        )
 
         client = Merge(
             account_token="YOUR_ACCOUNT_TOKEN",
@@ -198,6 +227,11 @@ class CollectionsClient:
         client.ticketing.collections.viewers_list(
             collection_id="collection_id",
             cursor="cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
+            expand=CollectionsViewersListRequestExpand.TEAM,
+            include_deleted_data=True,
+            include_remote_data=True,
+            include_shell_data=True,
+            page_size=1,
         )
         """
         _response = self._raw_client.viewers_list(
@@ -263,6 +297,8 @@ class CollectionsClient:
         )
         client.ticketing.collections.retrieve(
             id="id",
+            include_remote_data=True,
+            include_shell_data=True,
         )
         """
         _response = self._raw_client.retrieve(
@@ -295,7 +331,7 @@ class AsyncCollectionsClient:
     async def list(
         self,
         *,
-        collection_type: typing.Optional[str] = None,
+        collection_type: typing.Optional[CollectionsListRequestCollectionType] = None,
         created_after: typing.Optional[dt.datetime] = None,
         created_before: typing.Optional[dt.datetime] = None,
         cursor: typing.Optional[str] = None,
@@ -318,7 +354,7 @@ class AsyncCollectionsClient:
 
         Parameters
         ----------
-        collection_type : typing.Optional[str]
+        collection_type : typing.Optional[CollectionsListRequestCollectionType]
             If provided, will only return collections of the given type.
 
         created_after : typing.Optional[dt.datetime]
@@ -352,7 +388,7 @@ class AsyncCollectionsClient:
             If provided, will only return collections with this name.
 
         page_size : typing.Optional[int]
-            Number of results to return per page.
+            Number of results to return per page. The maximum limit is 100.
 
         parent_collection_id : typing.Optional[str]
             If provided, will only return collections whose parent collection matches the given id.
@@ -377,8 +413,12 @@ class AsyncCollectionsClient:
         Examples
         --------
         import asyncio
+        import datetime
 
         from merge import AsyncMerge
+        from merge.resources.ticketing.resources.collections import (
+            CollectionsListRequestCollectionType,
+        )
 
         client = AsyncMerge(
             account_token="YOUR_ACCOUNT_TOKEN",
@@ -388,7 +428,27 @@ class AsyncCollectionsClient:
 
         async def main() -> None:
             await client.ticketing.collections.list(
+                collection_type=CollectionsListRequestCollectionType.EMPTY,
+                created_after=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
+                created_before=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
                 cursor="cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
+                include_deleted_data=True,
+                include_remote_data=True,
+                include_shell_data=True,
+                modified_after=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
+                modified_before=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
+                name="name",
+                page_size=1,
+                parent_collection_id="parent_collection_id",
+                remote_id="remote_id",
             )
 
 
@@ -465,6 +525,9 @@ class AsyncCollectionsClient:
         import asyncio
 
         from merge import AsyncMerge
+        from merge.resources.ticketing.resources.collections import (
+            CollectionsViewersListRequestExpand,
+        )
 
         client = AsyncMerge(
             account_token="YOUR_ACCOUNT_TOKEN",
@@ -476,6 +539,11 @@ class AsyncCollectionsClient:
             await client.ticketing.collections.viewers_list(
                 collection_id="collection_id",
                 cursor="cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
+                expand=CollectionsViewersListRequestExpand.TEAM,
+                include_deleted_data=True,
+                include_remote_data=True,
+                include_shell_data=True,
+                page_size=1,
             )
 
 
@@ -549,6 +617,8 @@ class AsyncCollectionsClient:
         async def main() -> None:
             await client.ticketing.collections.retrieve(
                 id="id",
+                include_remote_data=True,
+                include_shell_data=True,
             )
 
 

merge/resources/ticketing/resources/collections/raw_client.py

@@ -14,6 +14,7 @@ from .....core.unchecked_base_model import construct_type
 from ...types.collection import Collection
 from ...types.paginated_collection_list import PaginatedCollectionList
 from ...types.paginated_viewer_list import PaginatedViewerList
+from .types.collections_list_request_collection_type import CollectionsListRequestCollectionType
 from .types.collections_viewers_list_request_expand import CollectionsViewersListRequestExpand
 
 
@@ -24,7 +25,7 @@ class RawCollectionsClient:
     def list(
         self,
         *,
-        collection_type: typing.Optional[str] = None,
+        collection_type: typing.Optional[CollectionsListRequestCollectionType] = None,
         created_after: typing.Optional[dt.datetime] = None,
         created_before: typing.Optional[dt.datetime] = None,
         cursor: typing.Optional[str] = None,
@@ -47,7 +48,7 @@ class RawCollectionsClient:
 
         Parameters
         ----------
-        collection_type : typing.Optional[str]
+        collection_type : typing.Optional[CollectionsListRequestCollectionType]
             If provided, will only return collections of the given type.
 
         created_after : typing.Optional[dt.datetime]
@@ -81,7 +82,7 @@ class RawCollectionsClient:
             If provided, will only return collections with this name.
 
         page_size : typing.Optional[int]
-            Number of results to return per page.
+            Number of results to return per page. The maximum limit is 100.
 
         parent_collection_id : typing.Optional[str]
             If provided, will only return collections whose parent collection matches the given id.
@@ -290,7 +291,7 @@ class AsyncRawCollectionsClient:
     async def list(
         self,
         *,
-        collection_type: typing.Optional[str] = None,
+        collection_type: typing.Optional[CollectionsListRequestCollectionType] = None,
         created_after: typing.Optional[dt.datetime] = None,
         created_before: typing.Optional[dt.datetime] = None,
         cursor: typing.Optional[str] = None,
@@ -313,7 +314,7 @@ class AsyncRawCollectionsClient:
 
         Parameters
         ----------
-        collection_type : typing.Optional[str]
+        collection_type : typing.Optional[CollectionsListRequestCollectionType]
             If provided, will only return collections of the given type.
 
         created_after : typing.Optional[dt.datetime]
@@ -347,7 +348,7 @@ class AsyncRawCollectionsClient:
             If provided, will only return collections with this name.
 
         page_size : typing.Optional[int]
-            Number of results to return per page.
+            Number of results to return per page. The maximum limit is 100.
 
         parent_collection_id : typing.Optional[str]
             If provided, will only return collections whose parent collection matches the given id.

merge/resources/ticketing/resources/collections/types/__init__.py

@@ -6,9 +6,11 @@ import typing
 from importlib import import_module
 
 if typing.TYPE_CHECKING:
+    from .collections_list_request_collection_type import CollectionsListRequestCollectionType
     from .collections_viewers_list_request_expand import CollectionsViewersListRequestExpand
 _dynamic_imports: typing.Dict[str, str] = {
-    "CollectionsViewersListRequestExpand": ".collections_viewers_list_request_expand"
+    "CollectionsListRequestCollectionType": ".collections_list_request_collection_type",
+    "CollectionsViewersListRequestExpand": ".collections_viewers_list_request_expand",
 }
 
 
@@ -31,4 +33,4 @@ def __dir__():
     return sorted(lazy_attrs)
 
 
-__all__ = ["CollectionsViewersListRequestExpand"]
+__all__ = ["CollectionsListRequestCollectionType", "CollectionsViewersListRequestExpand"]

merge/resources/ticketing/resources/collections/types/collections_list_request_collection_type.py

@@ -0,0 +1,25 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import enum
+import typing
+
+T_Result = typing.TypeVar("T_Result")
+
+
+class CollectionsListRequestCollectionType(str, enum.Enum):
+    EMPTY = ""
+    LIST = "LIST"
+    PROJECT = "PROJECT"
+
+    def visit(
+        self,
+        empty: typing.Callable[[], T_Result],
+        list_: typing.Callable[[], T_Result],
+        project: typing.Callable[[], T_Result],
+    ) -> T_Result:
+        if self is CollectionsListRequestCollectionType.EMPTY:
+            return empty()
+        if self is CollectionsListRequestCollectionType.LIST:
+            return list_()
+        if self is CollectionsListRequestCollectionType.PROJECT:
+            return project()