Skip to Content

MC1253577: Information regarding the end of support for Global Discovery Service (GDS) API

By: Author Alex Lim

Posted on

Categories Update

Home » Update » MC1253577: Information regarding the end of support for Global Discovery Service (GDS) API

Summary

  • The Global Discovery Service (GDS) API will be retired, and its REST API endpoints will no longer be available.
  • Applications and scripts using GDS endpoints need to be identified and updated to use the Power Platform List Environments API.
  • Testing of updated integrations against the new endpoints is required to ensure compatibility.
  • Authentication must be updated to request tokens with a new scope and register the Power Platform API in Microsoft Entra.
  • Migrating to the new API is necessary to avoid service disruption.

Admin Impact: High
User Impact: Low
Release Start: 08 Jun 2026
Release End: 08 Jun 2026
Services: Power Platform
Category: Stay informed
Tags: Admin Action, Retirement

History

3/16/2026 Item Added to Message Center

Microsoft Message

Update: End of support date of this API has been updated.

On June 19, 2026, the Global Discovery Service (GDS) API will have reached end of support.

How does this affect me?

The legacy Global Discovery Service (GDS) REST API endpoints hosted at globaldisco.crm.dynamics.com will no longer be available.

Deprecated GDS endpoints:

  • https://globaldisco.crm.dynamics.com/api/discovery/v1.0/Instances
  • https://globaldisco.crm.dynamics.com/api/discovery/v2.0/Instances
  • https://globaldisco.crm.dynamics.com/api/discovery/v1.0/Instances({id})

What action do I need to take?

  1. Identify any applications or scripts that call globaldisco.crm.dynamics.com REST API endpoints.
  2. Update your applications to use the Power Platform List Environments API instead of the GDS endpoints.
  3. Test your updated integrations against the new endpoints to verify compatibility.

Please note that the Power Platform API uses a different token audience than GDS. You will need to update your authentication to request tokens with the scope (https://api.powerplatform.com/.default) and register the Power Platform API (app ID 8578e004-a5c6-46e7-913e-12f58912df43) as an API permission in your Microsoft Entra app registration. For detailed setup instructions, see Power Platform API Authentication.

To avoid a disruption in service, please migrate to the Power Platform List Environments API before June 19, 2026.

If you need additional assistance, please contact Microsoft Support.