# metalcloud-cli permission list

List all available system permissions

## Synopsis

List all available system permissions.

This command displays all permissions available in the MetalCloud system, including
their IDs, names, labels, and descriptions. Permissions control access to various
system resources and operations.

The output includes:
  - ID: Unique identifier for the permission
  - Label: Human-readable label for the permission
  - Name: Technical name of the permission
  - Description: Detailed description of what the permission allows

Required Permissions:
  - roles:read: Required to view permission information

Examples:
  ## List all permissions
  metalcloud-cli permission list
  
  ## List permissions using alias
  metalcloud-cli permissions ls
  
  ## List permissions with JSON output format
  metalcloud-cli permission list --format json

```
metalcloud-cli permission list [flags]
```

### Options

```
  -h, --help   help for list
```

### Options inherited from parent commands

```
  -k, --api_key string         MetalCloud API key
  -c, --config string          Config file path
  -d, --debug                  Set to enable debug logging
  -e, --endpoint string        MetalCloud API endpoint
  -f, --format string          Output format. Supported values are 'text','csv','md','json','yaml'. (default "text")
  -i, --insecure_skip_verify   Set to allow insecure transport
  -l, --log_file string        Log file path
  -v, --verbosity string       Log level verbosity (default "INFO")
```

### SEE ALSO

* [metalcloud-cli permission](/content/configuration/cli/metalcloud-cli_permission.md)	 - Manage system permissions and access control

#### Auto generated by spf13/cobra on 11-Aug-2025