Skip to main content

app permission list

Lists API permissions for the current Microsoft Entra app

Usage​

m365 app permission list [options]

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 http://jmespath.org/ for more information and examples.

-o, --output [output]

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

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

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.

Examples​

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

Response​

[
  {
    "resource": "Microsoft Teams - Teams And Channels Service",
    "permission": "channels.readwrite",
    "type": "Application"
  }
]
CTRL + M