CIPP.app icon

CIPP.app

Manage Microsoft 365 tenants via CIPP.app

Actions619

Mailbox → Set Litigation Hold

AI-generated

Summary

Set or clear litigation hold for a mailbox in the selected tenant, with an optional duration when enabling the hold.

Inputs

  • Tenant (required) — Select the tenant from the list or enter its domain.
  • User ID (required) — Mailbox owner's User Principal Name (UPN).
  • Enabled (required) — Enable or disable litigation hold; defaults to enabled.
  • Duration (Days) — Hold duration in days when enabled; defaults to 0, meaning unlimited.

Output shape

A single API response item.

This operation changes the mailbox's litigation hold settings. The duration field is shown only when Enabled is true.

Links

Discussion