> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plerion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# plerion asset-groups

> Create, update, list, and delete asset groups.

With **plerion asset-groups**, you can create, update, list, and delete asset groups to organize your cloud resources.

<Tip>
  For more about asset groups in the Plerion dashboard, see [Asset groups](/guides/platform/asset-groups).
</Tip>

***

## Synopsis

```bash theme={"system"}
plerion asset-groups <subcommand> [options]
```

***

## Subcommands

### list

```bash theme={"system"}
plerion asset-groups list [--name <n>] [--include-total] [--per-page N] [--all]
```

| Option            | Type   | Description                     |
| ----------------- | ------ | ------------------------------- |
| `--name`          | string | Filter by name                  |
| `--include-total` | flag   | Include total count in response |
| `--per-page`      | number | Results per page                |
| `--all`           | flag   | Fetch all pages automatically   |

### get

```bash theme={"system"}
plerion asset-groups get --id <id>
```

### create

```bash theme={"system"}
plerion asset-groups create --name <name> --rules <json>
```

### update

```bash theme={"system"}
plerion asset-groups update --id <id> [--name <n>] [--rules <json>]
```

### delete

```bash theme={"system"}
plerion asset-groups delete --id <id>
```

***

## Examples

```bash theme={"system"}
# List all asset groups
plerion asset-groups list

# Fetch all asset groups across all pages
plerion asset-groups list --all

# Create a new group with rules
plerion asset-groups create --name "Critical Servers" \
  --rules '[{"field":"provider","operator":"equals","value":"AWS"}]'

# Update a group name
plerion asset-groups update --id ag-abc123 --name "Production - All Providers"

# Delete a group
plerion asset-groups delete --id ag-abc123

# Get group details
plerion asset-groups get --id ag-abc123 --output json
```

***

## Output columns

| Column     | Description        |
| ---------- | ------------------ |
| ID         | Asset group ID     |
| NAME       | Asset group name   |
| STATUS     | Group status       |
| ASSETS     | Total asset count  |
| RISK SCORE | Numeric risk score |
| TENANT ID  | Tenant ID          |
| ORG ID     | Organization ID    |
| CREATED AT | Creation timestamp |
| UPDATED AT | Update timestamp   |