Like public apps, apps that are created in the Shopify admin also might require occasional updates to make sure that they stay up-to-date with our supported API versions.

## How do I know if my custom apps are affected?

If your custom apps are currently making deprecated calls, you will receive notifications in a few different ways.

### Banners

<figure class="figure"><img src="https://cdn.shopify.com/shopifycloud/shopify_dev/assets/api/versioning/merchant-app-banner-20df66c7f3aa1b932437b5b8ea1fa69311c9050e1ae1c7df57fd8df040e47a0a.png" class="lazyload" alt="A banner in the Apps page of the Shopify admin that warns that your custom apps and webhooks might stop working." width="70%" height="362"></figure>

On your admin’s **Apps** page, you’ll find a banner warning you that your custom apps may stop working. To view which apps are at risk, click the **View custom apps** link.

<figure class="figure"><img src="https://cdn.shopify.com/shopifycloud/shopify_dev/assets/api/versioning/specific-merchant-app-banner-d8a6d0378bf5849da316da45521581f91e10cbaafbeff3c6988d50572a769cc9.png" class="lazyload" alt="A banner in the Develop Apps page of the Shopify admin that warns which of your custom apps and webhooks might stop working." width="70%" height="552"></figure>

In your admin's **Develop apps** page, you'll find a banner that lists your custom apps that are currently making deprecated calls and the deadline for migrating these requests.

### Emails

<figure class="figure"><img src="https://cdn.shopify.com/shopifycloud/shopify_dev/assets/api/versioning/deprecation-email-top-e38f89fdc125b02981940538b89481fe5d1d76b928580dc19e9aefae6ccc03bc.png" class="lazyload" width="1282" height="98"></figure>

<figure class="figure"><img src="https://cdn.shopify.com/shopifycloud/shopify_dev/assets/api/versioning/deprecation-email-body-3ce615765923273708583c3e84429897258a6b9b6b0d53f2ca7a5263a9d9ff1b.png" class="lazyload" width="1008" height="542"></figure>

When an API is deprecated, Shopify emails the [app developer](/docs/api/usage/versioning/updates#update-the-contact-details-for-a-custom-app-created-in-the-shopify-admin) of affected apps. These emails include a detailed breakdown of breaking changes that affect your app, and links to resources to help with your migration.

### Deprecated API calls endpoint

<figure class="figure"><img src="https://cdn.shopify.com/shopifycloud/shopify_dev/assets/api/versioning/deprecation-endpoint-request-497a544a09e835055d063fa836185ade5a21c6cc13c36493057093d63f7e795e.png" class="lazyload" width="725" height="151"></figure>

<figure class="figure"><img src="https://cdn.shopify.com/shopifycloud/shopify_dev/assets/api/versioning/deprecation-endpoint-response-5c9ad95430de86fa238ba68945eff27dde67956ba77bbf0f0bdc6f35d5d366f4.png" class="lazyload" width="739" height="802"></figure>

App developers can use their app credentials to retrieve a detailed list of recent deprecated requests. In this list, you’ll get a detailed breakdown of each recent deprecated request, and the breaking change that directly affects that request.

Refer to the [Deprecated API calls](/docs/api/admin-rest/latest/resources/deprecated-api-calls) reference documentation for more details.