{"id":11059,"date":"2022-07-22T09:48:13","date_gmt":"2022-07-22T16:48:13","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=11059"},"modified":"2022-10-12T16:07:25","modified_gmt":"2022-10-12T23:07:25","slug":"ediscovery-api-for-microsoft-graph-is-now-generally-available","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/ediscovery-api-for-microsoft-graph-is-now-generally-available\/","title":{"rendered":"eDiscovery API for Microsoft Graph is now generally available"},"content":{"rendered":"<p><span data-contrast=\"auto\">We are excited to announce the general availability of the Microsoft Graph APIs for Microsoft Purview eDiscovery (Premium) to help you automate common eDiscovery workflows and integrate third<\/span><span data-contrast=\"auto\">\u00a0party applications into eDiscovery (Premium).<\/span><\/p>\n<h2><span data-contrast=\"none\">Why use the Microsoft Graph APIs for Microsoft Purview eDiscovery (Premium)<\/span><span data-ccp-props=\"{&quot;335559738&quot;:40,&quot;335559739&quot;:0}\">\u00a0<\/span><\/h2>\n<p><span data-contrast=\"auto\">In many organizations, eDiscovery workflows are frequent, critical, and high volume. In the cases where there are common repeated tasks or a high volume of activities, the APIs will help provide a scalable way to repeat processes consistently and effectively.<\/span><\/p>\n<h3><span data-contrast=\"none\">Customers\/Tenants<\/span><span data-ccp-props=\"{&quot;335559738&quot;:40,&quot;335559739&quot;:0}\">\u00a0<\/span><\/h3>\n<p><span data-contrast=\"auto\">Integrate with 3<\/span><span data-contrast=\"auto\">rd<\/span><span data-contrast=\"auto\"> party or in-house legal systems, holds databases or review tools to automate workflows.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<h3 aria-level=\"3\"><span data-contrast=\"none\">Partners<\/span><span data-ccp-props=\"{&quot;335559738&quot;:40,&quot;335559739&quot;:0}\">\u00a0<\/span><\/h3>\n<p><span data-contrast=\"auto\">Build applications that enhance the Microsoft Purview eDiscovery (Premium) capabilities.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">For more information, refer to <\/span><a href=\"https:\/\/aka.ms\/ediscographapi\"><span data-contrast=\"none\">Use the Microsoft Graph eDiscovery API<\/span><\/a><span data-contrast=\"auto\"> and <\/span><a href=\"https:\/\/docs.microsoft.com\/graph\/security-concept-overview#build-custom-ediscovery-workflows-with-microsoft-graph\"><span data-contrast=\"none\">Manage your eDiscovery workflows<\/span><\/a><span data-contrast=\"auto\">.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<h2 aria-level=\"2\"><span data-contrast=\"none\">License requirements<\/span><\/h2>\n<p aria-level=\"2\"><span data-contrast=\"none\">The following licenses provide the rights to the APIs for eDiscovery (Premium) capabilities:<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:120,&quot;335559740&quot;:240}\">\u00a0<\/span><\/p>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"5\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559684&quot;:-2,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><span data-contrast=\"none\">Microsoft 365 E5\/A5<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:120,&quot;335559740&quot;:240}\">\u00a0<\/span><\/li>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"5\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559684&quot;:-2,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"2\" data-aria-level=\"1\"><span data-contrast=\"none\">Microsoft 365 E5\/A5\/F5 Compliance and F5 Security &amp; Compliance<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:120,&quot;335559740&quot;:240}\">\u00a0<\/span><\/li>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"5\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559684&quot;:-2,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"3\" data-aria-level=\"1\"><span data-contrast=\"none\">Microsoft 365 E5\/A5\/F5 eDiscovery and Audit<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:120,&quot;335559740&quot;:240}\">\u00a0<\/span><\/li>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"5\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559684&quot;:-2,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"4\" data-aria-level=\"1\"><span data-contrast=\"none\">Microsoft 365 Office E5\/A5<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:120,&quot;335559740&quot;:240}\">\u00a0<\/span><\/li>\n<\/ul>\n<p><span data-contrast=\"none\">Our Government Cloud customers will have access to APIs for eDiscovery (Premium) later this calendar year.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<p><span data-ccp-props=\"{}\"><span class=\"TextRun SCXW89080479 BCX9\" lang=\"EN-US\" xml:lang=\"EN-US\" data-contrast=\"none\"><span class=\"NormalTextRun CommentStart CommentHighlightPipeRest CommentHighlightRest SCXW89080479 BCX9\">The use of th<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">e \u2018<\/span><\/span><a class=\"Hyperlink SCXW89080479 BCX9\" href=\"https:\/\/docs.microsoft.com\/graph\/api\/security-ediscoveryreviewset-addtoreviewset?view=graph-rest-1.0&amp;tabs=http\" target=\"_blank\" rel=\"noreferrer noopener\"><span class=\"FieldRange SCXW89080479 BCX9\"><span class=\"TextRun Underlined SCXW89080479 BCX9\" lang=\"EN-US\" xml:lang=\"EN-US\" data-contrast=\"none\"><span class=\"NormalTextRun CommentStart CommentHighlightPipeRest CommentHighlightRest SCXW89080479 BCX9\" data-ccp-charstyle=\"Hyperlink\">addTo<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\" data-ccp-charstyle=\"Hyperlink\">R<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\" data-ccp-charstyle=\"Hyperlink\">eviewSet<\/span><\/span><\/span><\/a><span class=\"TextRun SCXW89080479 BCX9\" lang=\"EN-US\" xml:lang=\"EN-US\" data-contrast=\"none\"><span class=\"NormalTextRun CommentHighlightPipeRest CommentHighlightRest SCXW89080479 BCX9\">\u2019 <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">API <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">requires<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\"> an E5 license (listed above) which <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">provides<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\"> a seeded <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">capacity<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\"> without consumption cost until the seeded <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">capacity<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\"> is reached. <\/span><\/span><span class=\"TextRun Highlight SCXW89080479 BCX9\" lang=\"EN-US\" xml:lang=\"EN-US\" data-contrast=\"none\"><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">Seeded <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">capacity<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\"> is how much <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">v<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">olume <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">an app can <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">consume <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">before having to pay usage fees.<\/span> <span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">Capacity<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\"> is pooled at the tenant level\u2014the seeded <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">capacity<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\"> for all users in the tenant is added up and compared against the app&#8217;s usage in the tenant.<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\"> Once the customer exceeds seeded <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">capacity<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">, consumption meters will kick in. Consumption meter charges for <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">the \u2018<\/span><\/span><a class=\"Hyperlink SCXW89080479 BCX9\" href=\"https:\/\/docs.microsoft.com\/graph\/api\/security-ediscoveryreviewset-addtoreviewset?view=graph-rest-1.0&amp;tabs=http\" target=\"_blank\" rel=\"noreferrer noopener\"><span class=\"FieldRange SCXW89080479 BCX9\"><span class=\"TextRun Highlight Underlined SCXW89080479 BCX9\" lang=\"EN-US\" xml:lang=\"EN-US\" data-contrast=\"none\"><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\" data-ccp-charstyle=\"Hyperlink\">addToReviewSet<\/span><\/span><\/span><\/a><span class=\"TextRun Highlight SCXW89080479 BCX9\" lang=\"EN-US\" xml:lang=\"EN-US\" data-contrast=\"none\"><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">\u2019 <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">API usage beyond available seeded <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">capacity<\/span> <span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">is planned to <\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">commence<\/span> <span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">in <\/span><span class=\"NormalTextRun CommentStart CommentHighlightPipeRest CommentHighlightRest SCXW89080479 BCX9\">CY<\/span><span class=\"NormalTextRun ContextualSpellingAndGrammarErrorV2Themed CommentHighlightRest SCXW89080479 BCX9\">2<\/span><span class=\"NormalTextRun ContextualSpellingAndGrammarErrorV2Themed CommentHighlightRest SCXW89080479 BCX9\">3<\/span><span class=\"NormalTextRun ContextualSpellingAndGrammarErrorV2Themed CommentHighlightRest SCXW89080479 BCX9\">.<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\"> A<\/span> <span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">9<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\">0-day notice will be provided before these <\/span><span class=\"NormalTextRun ContextualSpellingAndGrammarErrorV2Themed CommentHighlightRest SCXW89080479 BCX9\">charges<\/span><span class=\"NormalTextRun CommentHighlightRest SCXW89080479 BCX9\"> are in effect.<\/span><\/span><\/span><\/p>\n<table style=\"font-weight: 400;\" data-tablestyle=\"MsoTableGrid\" data-tablelook=\"1184\" aria-rowcount=\"2\">\n<tbody>\n<tr aria-rowindex=\"1\">\n<td data-celllook=\"0\"><span data-contrast=\"auto\">API<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559740&quot;:259}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Seeded capacity<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559740&quot;:259}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Price for additional use<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559740&quot;:259}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Example<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559740&quot;:259}\">\u00a0<\/span><\/td>\n<\/tr>\n<tr aria-rowindex=\"2\">\n<td data-celllook=\"0\"><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/security-ediscoveryreviewset-addtoreviewset?view=graph-rest-1.0&amp;tabs=http\"><span data-contrast=\"none\">addToReviewSet<\/span><\/a><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559740&quot;:259}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">1 GB per licensed user per month \u2013 pooled at the tenant level<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559740&quot;:259}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">$15 per GB<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559740&quot;:259}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">An organization with 10,000 E5 licenses will get 10,000 GB per month pooled at the tenant level.\u00a0<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">If the organization uses 10,500 GB a month they will be charged $7,500 (500 GB x $15\/GB).<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559740&quot;:259}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">If the organization uses 9500 GB a month, they will not get charged any additional fee for the API usage and there is no carry over of 500 GB to the following month.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559740&quot;:259}\">\u00a0<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559740&quot;:259}\">\u00a0<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>eDiscovery endpoint availability<\/h2>\n<p><span data-contrast=\"auto\">The following eDiscovery endpoints are in preview and only available in beta.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<ul>\n<li><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/security-ediscoverysearch-purgedata?view=graph-rest-beta&amp;tabs=http\"><span data-contrast=\"none\">Search &gt; Purge data (preview)<\/span><\/a><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/resources\/security-ediscoveryholdpolicy?view=graph-rest-beta\"><span data-contrast=\"none\">Hold policy (preview)<\/span><\/a><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/resources\/security-ediscoveryexportoperation?view=graph-rest-beta\"><span data-contrast=\"none\">eDiscovery export operation (preview)<\/span><\/a><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/security-ediscoveryexportoperation-getdownloadurl?view=graph-rest-beta\"><span data-contrast=\"none\">eDiscovery export operation &gt; Get download URL (preview)<\/span><\/a><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/security-ediscoveryreviewset-export?view=graph-rest-beta&amp;tabs=http\"><span data-contrast=\"none\">Review set &gt; Export (preview)<\/span><\/a><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/security-ediscoveryreviewset-export?view=graph-rest-beta&amp;tabs=http\"><span data-contrast=\"none\">Review set &gt; Query &gt; Export (preview)<\/span><\/a><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/security-ediscoveryreviewsetquery-run?view=graph-rest-beta&amp;tabs=http\"><span data-contrast=\"none\">Review set &gt; Query &gt; Run (preview)<\/span><\/a><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/graph\/api\/resources\/security-ediscoveryfile?view=graph-rest-beta\"><span data-contrast=\"none\">eDiscoveryFile (preview)<\/span><\/a><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<p>Happy coding!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>We are excited to announce the general availability of the Microsoft Graph APIs for Microsoft Purview eDiscovery (Premium) to help you automate common eDiscovery workflows and integrate third\u00a0party applications into eDiscovery (Premium).\u00a0<\/p>\n","protected":false},"author":69077,"featured_media":25159,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3],"tags":[203,182,202],"class_list":["post-11059","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","tag-ediscovery","tag-ediscovery-api","tag-security"],"acf":[],"blog_post_summary":"<p>We are excited to announce the general availability of the Microsoft Graph APIs for Microsoft Purview eDiscovery (Premium) to help you automate common eDiscovery workflows and integrate third\u00a0party applications into eDiscovery (Premium).\u00a0<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/11059","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69077"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=11059"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/11059\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/25159"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=11059"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=11059"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=11059"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}