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

# resource-groups

> DevHelm CLI resource-groups commands — list, get, create, update, and delete resource groups

Manage resource groups from the command line. Aggregate monitors and services into unified health views.

## Commands

| Command                               | Description                |
| ------------------------------------- | -------------------------- |
| `devhelm resource-groups list`        | List all resource groups   |
| `devhelm resource-groups get <id>`    | Get resource group details |
| `devhelm resource-groups create`      | Create a resource group    |
| `devhelm resource-groups update <id>` | Update a resource group    |
| `devhelm resource-groups delete <id>` | Delete a resource group    |

## resource-groups list

```bash theme={null}
devhelm resource-groups list
```

| Flag          | Type    | Default | Description                             |
| ------------- | ------- | ------- | --------------------------------------- |
| `--page-size` | integer | `200`   | Number of items per API request (1–200) |

## resource-groups get

Resource group IDs are UUIDs — get them from `devhelm resource-groups list`.

```bash theme={null}
devhelm resource-groups get <group-id> -o json
```

## resource-groups create

```bash theme={null}
devhelm resource-groups create \
  --name "Payment Service" \
  --description "All monitors related to the payment pipeline"
```

| Flag            | Type   | Required | Description                 |
| --------------- | ------ | -------- | --------------------------- |
| `--name`        | string | Yes      | Resource group display name |
| `--description` | string | —        | Human-readable description  |

## resource-groups update

```bash theme={null}
devhelm resource-groups update <group-id> --name "Payment Service (v2)"
```

| Flag            | Type   | Required | Description                                                            |
| --------------- | ------ | -------- | ---------------------------------------------------------------------- |
| `--name`        | string | Yes      | Resource group name (required even when only changing the description) |
| `--description` | string | —        | New description                                                        |

## resource-groups delete

Prompts for confirmation; pass `--yes` (`-y`) in scripts and CI.

```bash theme={null}
devhelm resource-groups delete <group-id>
```

## Next steps

<CardGroup cols={2}>
  <Card title="Resource group health guide" icon="wrench" href="/guides/resource-group-health">
    Build composite health dashboards.
  </Card>

  <Card title="Monitors" icon="signal" href="/cli/commands/monitors">
    Add monitors to track within groups.
  </Card>
</CardGroup>