approveAppInstallationScopes

Requires permission settings:apps:install.

Approve the new access an installed app's latest version asks for. You can grant only access whose permissions you hold.

Errors: a failed call returns a GraphQL errors entry, not a field on the result, and data may be null or partial. Read the entry's extensions.code and message; every shape and code is in the Error reference.

Example:

GraphQL

mutation ApproveAppInstallationScopes($installationId: ID!) {
  approveAppInstallationScopes(installationId: $installationId) {
    id
    status
    appId
    appVersionId
    grantedScopes
    installedAt
  }
}

cURL

curl -X POST "https://<api-host>/graphql" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data @- <<'EOF'
{
  "query": "mutation ApproveAppInstallationScopes($installationId: ID!) {\n  approveAppInstallationScopes(installationId: $installationId) {\n    id\n    status\n    appId\n    appVersionId\n    grantedScopes\n    installedAt\n  }\n}",
  "variables": {
    "installationId": "id"
  }
}
EOF

Variables:

{
  "installationId": "id"
}

Response:

{
  "data": {
    "approveAppInstallationScopes": {
      "id": "id",
      "status": "string",
      "appId": "id",
      "appVersionId": "id",
      "grantedScopes": [
        "string"
      ],
      "installedAt": "2025-01-15T00:00:00Z"
    }
  }
}

approveAppInstallationScopes(
  installationId: ID!
): AppInstallationView!

Arguments

approveAppInstallationScopes.installationId ● ID! non-null scalar

The installation whose new access to approve.

Type

AppInstallationView object

One app installed in this organization. The app acts as its own user, with only the access granted here.