Skip to main content
Anchor to appDowngradeAccessScopes

appDowngradeAccessScopes

mutation

Downgrades granted optional write access scopes to their matching read access scopes. For example, downgrading write_products removes write_products and keeps read_products, so the app can keep reading products without asking the merchant to grant read_products again.

Revoking a write scope with appRevokeAccessScopes also removes its read access when the read scope was only granted through the write scope. Use this mutation instead when the app still needs read access.

The mutation always acts on the calling app's own installation on the shop. Only write scopes that the app declares as optional can be downgraded. Required scopes can't be downgraded. Write scopes that aren't currently granted are ignored.

Learn more about managing app permissions.

•[String!]!
required

The handles of the write scopes to downgrade, for example write_products. Each granted write scope is replaced with its matching read scope.


Was this section helpful?

Anchor to AppDowngradeAccessScopesPayload returnsAppDowngradeAccessScopesPayload returns

•[AccessScope!]

The write scopes that were downgraded. The app keeps the matching read scope for each one.

Show fields
•[AppDowngradeAccessScopesUserError!]!
non-null

The list of errors that occurred from executing the mutation.

Show fields

Was this section helpful?