Skip to main content

Remove SharePoint API permissions

Author: Waldek Mastykarz

When building SharePoint Framework solutions connected to APIs secured with Microsoft Entra ID, you might need to clear the list of granted API permissions.

This script helps you to quickly remove SharePoint API permissions.

#!/usr/bin/env zx
$.verbose = false;

console.log('Retrieving granted API permissions...');
const apiPermissions = JSON.parse(await $`m365 serviceprincipal sp grant list -o json`);

for (let i = 0; i < apiPermissions.length; i++) {
const permission = apiPermissions[i];
console.log(`Removing permission ${permission.Resource}/${permission.Scope} (${permission.ObjectId})...`);
try {
await $`m365 spo serviceprincipal grant revoke --id ${permission.ObjectId}`
catch (err) {

Using CLI for Microsoft 365, the script first retrieves the list of granted API permissions. Then, it iterates through them and removes (revokes) each one of them using CLI for Microsoft 365. After running this script, your list of SharePoint API permissions will be empty.

This script uses CLI for Microsoft 365 and Google zx.

To run the script, save it to a file with the .mjs extension. Next, run the script either by calling zx remove-apipermissions.mjs or ./remove-apipermissions.mjs after making the script executable using chmod +x ./remove-apipermissions.mjs;