[Introduction]

We’re retiring the Microsoft Defender for Endpoint (MDE) API and XDR API and transitioning customers to the Microsoft Graph Security API. This update aligns our security integrations with a unified interface and schema across Microsoft Defender products. The Microsoft Graph Security API provides broader data coverage, improved consistency, and better scalability for automation and security workflows.

[When this will happen] 

• Retirement start: February 6, 2026
• Full retirement: February 1, 2027
  
• After February 1, 2027, the MDE and XDR APIs will no longer function.

[How this affects your organization]

Who is affected: 

• Organizations using the MDE API or XDR API for automation, integration, or custom workflows.
• You are receiving this message because our reporting indicates your organization may be using these APIs.

What will happen:

• The MDE and XDR APIs will stop functioning after February 1, 2027.
• Existing scripts, automations, and workflows that rely on these APIs will fail if not updated.
• The Microsoft Graph Security API will be the supported API for accessing Microsoft security data.
• No automatic migration will occur; manual updates will be required.

[What you can do to prepare]

• Migrate all existing API workflows to the Microsoft Graph Security API by January 31, 2027.
• Update internal documentation, automation scripts, and integration endpoints to use the Microsoft Graph Security API.
• Communicate these changes to your security operations, engineering, and development teams.
• Review Microsoft documentation to plan your migration: Use the Microsoft Graph security API.
• If your organization uses custom solutions, validate that new queries and response schemas work as expected before the retirement date.

Learn more:

• Advanced hunting – Use the Microsoft Graph security API | Microsoft Graph | Microsoft Learn
• Migrate from the older APIs – Use the Microsoft Graph security API | Microsoft Graph | Microsoft Learn
• (to be retired) Microsoft Defender for Endpoint (MDE) API
• (to be retired) Microsoft Defender XDR API

[Compliance considerations]

No compliance considerations identified. Review as appropriate for your organization.

[はじめに]

Microsoft Defender for Endpoint(MDE)APIとXDR APIを廃止し、顧客をMicrosoft Graph Security APIに移行させます。このアップデートにより、Microsoft Defender製品全体でセキュリティ統合が統一されたインターフェースとスキーマに整合します。Microsoft Graph Security APIは、より広範なデータカバレッジ、一貫性の向上、そして自動化およびセキュリティワークフローのスケーラビリティを向上させます。

[いつ起こるか] 

• 退職開始日: 2026年2月6日
• 完全退職: 2027年2月1日
  
• 2027年2月1日以降、MDEおよびXDRのAPIは機能しなくなります。

[これがあなたの組織に与える影響]

影響を受ける人物: 

• 組織は、自動化、統合、カスタムワークフローのためにMDE APIまたはXDR APIを使用しています。
• このメッセージを受け取るのは、当社の報告によると、御社がこれらのAPIを使用している可能性があると示されているためです。

今後の展開:

• MDEおよびXDRのAPIは2027年2月1日をもって機能停止します。
• これらのAPIに依存している既存のスクリプト、自動化、ワークフローは更新されなければ失敗します。
• Microsoft Graph Security APIは、MicrosoftのセキュリティデータにアクセスするためのサポートAPIとなります。
• 自動移行は行われません 。 手動での更新が必要です。

【準備のためにできること】

• 2027年1月31日までに、すべての既存のAPIワークフローをMicrosoft Graph Security APIに移行してください。
• Microsoft Graph Security APIを使用するために内部ドキュメント、自動化スクリプト、統合エンドポイントを更新してください。
• これらの変更をセキュリティ運用、エンジニアリング、開発チームに伝えてください。
• 移行計画のためにMicrosoftのドキュメントを確認しましょう: Microsoft GraphのセキュリティAPIを活用してください。
• もし組織がカスタムソリューションを使用している場合は、新しいクエリやレスポンススキーマが定年前に期待通りに動作しているか確認してください。

詳細情報：

• 高度なハンティング – Microsoft GraphセキュリティAPIの使用 |Microsoft Graph |Microsoft Learn
• 古いAPIからの移行 – Microsoft GraphセキュリティAPIを使用 |Microsoft Graph |Microsoft Learn
• (廃止予定) Microsoft Defender for Endpoint (MDE) API
• (退役予定) Microsoft Defender XDR API

[コンプライアンスの考慮事項]

コンプライアンス上の考慮事項は特定されていません。あなたの組織に応じてレビューを行ってください。