---
title: appUninstall - GraphQL Admin
description: >-
  Uninstalls an app from a shop.


  This mutation can only be used by apps to uninstall themselves. Apps with the
  `apps` access scope can uninstall other apps by providing the app ID in the
  input parameter.


  Use the `appUninstall` mutation to programmatically remove apps from shops.


  The mutation returns the uninstalled app and any errors that occurred during
  the uninstallation process.


  Learn more about [app lifecycle
  management](https://shopify.dev/docs/apps/build/authentication-authorization/app-installation/uninstall-app-api-request).
api_version: unstable
api_name: admin
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/unstable/mutations/appUninstall'
  md: >-
    https://shopify.dev/docs/api/admin-graphql/unstable/mutations/appUninstall.md
---

# app​Uninstall

mutation

Requires This mutation can only be used by apps to uninstall themselves.

Uninstalls an app from a shop.

This mutation can only be used by apps to uninstall themselves. Apps with the `apps` access scope can uninstall other apps by providing the app ID in the input parameter.

Use the `appUninstall` mutation to programmatically remove apps from shops.

The mutation returns the uninstalled app and any errors that occurred during the uninstallation process.

Learn more about [app lifecycle management](https://shopify.dev/docs/apps/build/authentication-authorization/app-installation/uninstall-app-api-request).

## App​Uninstall​Payload returns

* app

  [App](https://shopify.dev/docs/api/admin-graphql/unstable/objects/App)

  The uninstalled app.

* user​Errors

  [\[App​Uninstall​App​Uninstall​Error!\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/AppUninstallAppUninstallError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### appUninstall reference

## Mutation Reference

```graphql
mutation appUninstall {
  appUninstall {
    app {
      # App fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

##### Variables

```json
{}
```