# metalcloud-cli role

Manage user roles and permissions

## Synopsis

Manage user roles and permissions in the MetalCloud platform.

Roles define sets of permissions that can be assigned to users to control access
to various platform features and resources. This command group provides operations
to list, view, create, update, and delete roles.

Available operations:
  list    - List all available roles
  get     - View detailed information about a specific role
  create  - Create a new role with specified permissions
  update  - Update an existing role's permissions or metadata
  delete  - Remove a role from the system

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

  ## View details of a specific role
  metalcloud-cli role get admin-role

  ## Create a new role from a JSON file
  metalcloud-cli role create --config-source role-config.json

  ## Update a role using piped JSON
  echo '{"permissions": ["read", "write"]}' | metalcloud-cli role update my-role --config-source pipe

### Options

```
  -h, --help   help for role
```

### 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](/content/configuration/cli/metalcloud-cli.md)	 - MetalCloud CLI
* [metalcloud-cli role create](/content/configuration/cli/metalcloud-cli_role_create.md)	 - Create a new role with specified permissions
* [metalcloud-cli role delete](/content/configuration/cli/metalcloud-cli_role_delete.md)	 - Delete a role from the system
* [metalcloud-cli role get](/content/configuration/cli/metalcloud-cli_role_get.md)	 - Get detailed information about a specific role
* [metalcloud-cli role list](/content/configuration/cli/metalcloud-cli_role_list.md)	 - List all available roles
* [metalcloud-cli role update](/content/configuration/cli/metalcloud-cli_role_update.md)	 - Update an existing role's permissions or metadata

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