# metalcloud-cli role list

List all available roles

## Synopsis

List all available roles in the MetalCloud platform.

This command displays a table of all roles with their ID, label, name, description,
and the number of users assigned to each role. The output includes both system
roles and custom roles created by administrators.

Examples:
  ## List all roles
  metalcloud-cli role list

  ## List roles using alias
  metalcloud-cli roles ls

```
metalcloud-cli role 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 role](/content/configuration/cli/metalcloud-cli_role.md)	 - Manage user roles and permissions

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