Skip to content

app permission list

Lists API permissions for the current AAD app

Usage

m365 app permission list [options]

Options

--appId [appId]
Client ID of the Azure AD 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 full.
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv,md. 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 Azure AD 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 Azure AD app

m365 app permission list

Retrieve API permissions for the Azure AD app with client ID e23d235c-fcdf-45d1-ac5f-24ab2ee0695d 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"
  },
  {
    "resource": "Yammer",
    "permission": "access_as_user",
    "type": "Delegated"
  },
  {
    "resource": "Yammer",
    "permission": "user_impersonation",
    "type": "Delegated"
  }
]
resource                                      permission          type
--------------------------------------------  ------------------  -----------
Microsoft Teams - Teams And Channels Service  channels.readwrite  Application
Yammer                                        access_as_user      Delegated
Yammer                                        user_impersonation  Delegated
resource,permission,type
Microsoft Teams - Teams And Channels Service,channels.readwrite,Application
Yammer,access_as_user,Delegated
Yammer,user_impersonation,Delegated