Updated January 26, 2026: We have updated the content. Thank you for your patience. 

[Introduction]

We’re retiring the Microsoft Defender for Endpoint (MDE) Advanced Hunting API and Microsoft Defender XDR Advanced Hunting 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 or XDR Advanced Hunting 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 Advanced Hunting 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) Advanced Hunting API – Microsoft Defender for Endpoint | Microsoft Learn
• (to be retired) Microsoft Defender XDR advanced hunting API – Microsoft Defender XDR | Microsoft Learn

[Compliance considerations]

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

2026年1月26日更新:コンテンツを更新しました。ご辛抱いただきありがとうございます。 

[はじめに]

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

[いつ起こるか] 

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

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

影響を受ける人物: 

• MDEまたは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
• (退職予定) Advanced Hunting API – Microsoft Defender for Endpoint |Microsoft Learn
• (退職予定) Microsoft Defender XDR advanced hunting API – Microsoft Defender XDR |Microsoft Learn

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

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