Once you create a legal hold matter in the Code42 console, you can use the Code42 CLI to add or release custodians from the matter.
Use the legal-hold
commands to manage legal hold custodians.
- To see a list of all the users currently in your organization, you can export a list from the Users action menu.
- To view a list of legal hold matters for your organization, including the matter ID, use the following command:
code42 legal-hold list
- To see a list of all the custodians currently associated with a legal hold matter, enter
code42 legal-hold show <matterID>
.
To add multiple custodians to a legal hold matter:
-
Generate a CSV template. Below is an example command that generates a template to use when bulk adding custodians to legal hold matter. Once generated, the CSV file is saved to your current working directory.
code42 legal-hold bulk generate-template add
To generate a template to use when bulk releasing custodians from a legal hold matter:
code42 legal-hold bulk generate-template remove
The CSV templates for
add
andremove
have the same columns, but the commands generate different default filenames. -
Use the CSV template to enter the matter ID(s) and Code42 usernames for the custodians you want to add to the matters. To get the ID for a matter, enter
code42 legal-hold list
. -
Save the CSV file.
You can add one or more custodians to a legal hold matter using the Code42 CLI.
Once you have entered the matter ID and user information in the CSV file, use the bulk add
command with the CSV file path to add multiple custodians at once. For example:
code42 legal-hold bulk add /Users/admin/add_users_to_legal_hold.csv
To add a single custodian to a legal hold matter, use the following command as an example:
code42 legal-hold add-user --matter-id 123456789123456789 --username user@example.com
--matter-id
(required): The identification number of the legal hold matter. To get the ID for a matter, run the commandcode42 legal-hold list
.--username
(required): The Code42 username of the custodian to add to the matter.--profile
(optional): The profile to use to execute the command. If not specified, the default profile is used.
You can release one or more custodians from a legal hold matter using the Code42 CLI.
To release multiple custodians at once:
- Enter the matter ID(s) and Code42 usernames to the CSV file template you generated.
- Save the file to your current working directory.
- Use the
bulk remove
command with the file path of the CSV you created. For example:code42 legal-hold bulk remove /Users/admin/remove_users_from_legal_hold.csv
Use remove-user
to release a single custodian. For example:
code42 legal-hold remove-user --matter-id 123456789123456789 --username user@example.com
Options are the same as add-user
shown above.
You can use the Code42 CLI to get a list of all the legal hold matters for your organization, or get full details for a matter.
To view a list of legal hold matters for your organization, use the following command:
code42 legal-hold list
This command produces the matter ID, name, description, creator, and creation date for the legal hold matters.
To view active custodians for a legal hold matter, enter code42 legal-hold show
with the matter ID, for example:
code42 legal-hold show 123456789123456789
To view active custodians for a legal hold matter, as well as the details of the preservation policy, enter
code42 legal-hold show <matterID> --include-policy
To view all custodians (including inactive) for a legal hold matter, enter
code42 legal-hold show <matterID> --include-inactive
To view a list of legal hold administrative events, use the following command:
code42 legal-hold search-events
This command takes the optional filters of a specific matter uid, beginning timestamp, end timestamp, and event type.
Learn more about the Legal Hold commands.