Skip to main content

app permission list

Lists API permissions for the current Microsoft Entra app


m365 app permission list [options]


--appId [appId]

Client ID of the Microsoft Entra app registered in the .m365rc.json file to retrieve API permissions for.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.


Runs command with verbose logging.


Runs command with debug logging.


Use this command to quickly look up API permissions for the Microsoft Entra application registration registered in the .m365rc.json file in your current project (folder).

If you have multiple apps registered in your .m365rc.json file, you can specify the app for which you'd like to retrieve permissions using the --appId option. If you don't specify the app using the --appId option, you'll be prompted to select one of the applications from your .m365rc.json file.


Retrieve API permissions for your current Microsoft Entra app.

m365 app permission list

Retrieve API permissions for the Microsoft Entra app with the client ID specified in the .m365rc.json file.

m365 app permission list --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d


"resource": "Microsoft Teams - Teams And Channels Service",
"permission": "channels.readwrite",
"type": "Application"