> ## 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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.