CIPP Advanced icon

CIPP Advanced

Advanced Microsoft 365 multi-tenant management via CIPP.app (465 operations, 29 resources)

Actions467

Mailbox → Set Litigation Hold

AI-generated

Summary

Enable or disable litigation hold for a mailbox in the selected tenant. When enabling it, optionally set the hold duration in days; leave the duration blank for an indefinite hold.

Inputs

  • Tenant (required) — Select a tenant from the list or enter its domain.
  • User ID (required) — The mailbox owner's user principal name, such as user@domain.com.
  • Hold Action (required) — Choose Enable or Disable; defaults to Enable.
  • Hold Duration (Days) — When enabling the hold, optionally provide its duration in days. Leave blank for an indefinite hold.
  • Normalize Numeric Strings — Convert numeric strings in the API response to numbers; defaults to false.

Output shape

A single API response item.

The operation updates the mailbox's litigation hold setting. The source pack shows the request routing but not the response unwrapping or output transformation, so the returned fields and exact response shape are unspecified.

Links

Discussion