Legal Hold¶
-
class
py42.clients.legalhold.
LegalHoldClient
(session)¶ Bases:
py42.clients.BaseClient
A client for interacting with Code42 Legal Hold APIs.
The LegalHoldClient provides the ability to manage Code42 Legal Hold Policies and Matters. It can:
Create, view, and list all existing Policies.
Create, view, deactivate, reactivate, and list all existing Matters.
Add/remove Custodians from a Matter.
-
add_to_matter
(user_uid, legal_hold_uid)¶ Add a user (Custodian) to a Legal Hold Matter. REST Documentation
- Parameters
user_uid (str) – The identifier of the user.
legal_hold_uid (str) – The identifier of the Legal Hold Matter.
- Returns
-
create_matter
(name, hold_policy_uid, description=None, notes=None, hold_ext_ref=None)¶ Creates a new, active Legal Hold Matter. REST Documentation
- Parameters
name (str) – The name of the new Legal Hold Matter.
hold_policy_uid (str) – The identifier of the Preservation Policy that will apply to this Matter.
description (str, optional) – An optional description of the Matter. Defaults to None.
notes (str, optional) – Optional notes information. Defaults to None.
hold_ext_ref (str, optional) – Optional external reference information. Defaults to None.
- Returns
-
create_policy
(name, policy=None)¶ Creates a new Legal Hold Preservation Policy. V4 REST Documentation
- Parameters
name (str) – The name of the new Policy.
policy (dict, optional) – The desired Preservation Policy settings as a dict. Defaults to None (where the server-default backup set is used).
- Returns
-
deactivate_matter
(legal_hold_uid)¶ Deactivates and closes a Legal Hold Matter. V4 REST Documentation
- Parameters
legal_hold_uid (str) – The identifier of the Legal Hold Matter.
- Returns
-
get_all_matter_custodians
(legal_hold_uid=None, user_uid=None, user=None, active=True)¶ Gets all Legal Hold memberships.
Each user (Custodian) who has been added to a Legal Hold Matter is returned by the server as a LegalHoldMembership object in the response body. If the object’s active state is “INACTIVE”, they have been removed from the Matter and are no longer subject to the Legal Hold retention rules. Users can be Custodians of multiple Legal Holds at once (and thus would be part of multiple LegalHoldMembership objects). REST Documentation
- Parameters
legal_hold_uid (str, optional) – Find LegalHoldMemberships for the Legal Hold Matter with this unique identifier. Defaults to None.
user_uid (str, optional) – Find LegalHoldMemberships for the user with this identifier. Defaults to None.
user (str, optional) – Find LegalHoldMemberships by flexibly searching on username, email, extUserRef, or last name. Will find partial matches. Defaults to None.
active (bool or None, optional) – Find LegalHoldMemberships by their active state. True returns active LegalHoldMemberships, False returns inactive LegalHoldMemberships, None returns all LegalHoldMemberships regardless of state. Defaults to True.
- Returns
An object that iterates over
py42.response.Py42Response
objects that each contain a page of LegalHoldMembership objects.- Return type
generator
-
get_all_matters
(creator_user_uid=None, active=True, name=None, hold_ext_ref=None)¶ Gets all existing Legal Hold Matters. REST Documentation
- Parameters
creator_user_uid (str, optional) – Find Matters by the identifier of the user who created them. Defaults to None.
active (bool or None, optional) – Find Matters by their active state. True returns active Matters, False returns inactive Matters, None returns all Matters regardless of state. Defaults to True.
name (str, optional) – Find Matters with a ‘name’ that either equals or partially contains this value. Defaults to None.
hold_ext_ref (str, optional) – Find Matters having a matching external reference field. Defaults to None.
- Returns
An object that iterates over
py42.response.Py42Response
objects that each contain a page of Legal Hold Matters.- Return type
generator
-
get_matter_by_uid
(legal_hold_uid)¶ Gets a single Legal Hold Matter. REST Documentation
- Parameters
legal_hold_uid (str) – The identifier of the Legal Hold Matter.
- Returns
A response containing the Matter.
- Return type
-
get_policy_by_uid
(legal_hold_policy_uid)¶ Gets a single Preservation Policy. V4 REST Documentation
- Parameters
legal_hold_policy_uid (str) – The identifier of the Preservation Policy.
- Returns
A response containing the Policy.
- Return type
-
get_policy_list
()¶ Gets a list of existing Preservation Policies. V4 REST Documentation
- Returns
A response containing the list of Policies.
- Return type
-
reactivate_matter
(legal_hold_uid)¶ Reactivates and re-opens a closed Matter. REST Documentation
- Parameters
legal_hold_uid (str) – The identifier of the Legal Hold Matter.
- Returns
-
remove_from_matter
(legal_hold_membership_uid)¶ Remove a user (Custodian) from a Legal Hold Matter. REST Documentation
- Parameters
legal_hold_membership_uid (str) – The identifier of the LegalHoldMembership representing the Custodian to Matter relationship.
- Returns