---
title: appRevokeAccessScopes - GraphQL Admin
description: Revokes access scopes previously granted for an app installation.
api_version: 2024-10
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/appRevokeAccessScopes
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/appRevokeAccessScopes.txt
---

# app​Revoke​Access​Scopes

mutation

Requires This mutation can only be run on the current app.

Revokes access scopes previously granted for an app installation.

## Arguments

* scopes

  [\[String!\]!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  required

  The list of scope handles to revoke.

***

## App​Revoke​Access​Scopes​Payload returns

* revoked

  [\[Access​Scope!\]](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/AccessScope)

  The list of scope handles that have been revoked.

* user​Errors

  [\[App​Revoke​Access​Scopes​App​Revoke​Scope​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/AppRevokeAccessScopesAppRevokeScopeError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### appRevokeAccessScopes reference

## Mutation Reference

```graphql
mutation appRevokeAccessScopes($scopes: [String!]!) {
  appRevokeAccessScopes(scopes: $scopes) {
    revoked {
      # AccessScope fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "scopes": [
    "<your-scopes>"
  ]
}
```