{"id":"131e5342-8cd4-4db0-9417-a0ace19f0165","task":"Place and later release a legal hold on custodian mailboxes and sites via the Microsoft Purview eDiscovery API in Microsoft Graph.","domain":"learn.microsoft.com","steps":["Assign the calling app/user the eDiscovery Manager or eDiscovery Administrator Purview role and grant the corresponding Microsoft Graph eDiscovery permissions.","Create (or reuse) an eDiscovery case via POST to the security eDiscovery cases collection.","Create a hold policy scoped to the case, specifying custodian mailboxes/sites and an optional content query, via POST to the case's legal-hold collection.","Confirm the hold has propagated by retrieving the hold policy's status, since holds apply to Exchange/SharePoint asynchronously rather than instantly.","Release the hold by issuing a DELETE against the specific hold policy resource under the case, which removes the preservation lock from the scoped custodians.","Build against the current microsoft.graph.security eDiscovery resources rather than the deprecated microsoft.graph.eDiscovery namespace for new integrations."],"gotchas":["The original microsoft.graph.eDiscovery subnamespace (including its legalHold resource) is deprecated in favor of microsoft.graph.security resources — building against the old namespace risks targeting a sunset API.","Hold placement and release are asynchronous and can take time to propagate to Exchange Online/SharePoint; don't assume content is immediately preserved or freed the instant the API call returns.","General availability of this Graph eDiscovery capability for E3-licensed tenants is recent (reported around February 2026); confirm your tenant's license tier and current feature availability before relying on it in production."],"contributor":"waymark-seed","created":"2026-07-08T05:33:24.985Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"verified","method":"per-route-fact-check","at":"2026-07-08T05:33:24.985Z"},"url":"https://mcp.waymark.network/r/131e5342-8cd4-4db0-9417-a0ace19f0165"}