---
title: "Keywords and groups"
description: "Create and adjust keywords, organize them in groups, and set workspace filters."
canonical: https://docs.rumoro.dev/cli/keywords
markdown: https://docs.rumoro.dev/cli/keywords.mdx
---

# Keywords and groups

Create and adjust keywords, organize them in groups, and set workspace filters.

Pass ids as arguments and everything else as flags with the API's field names. The [API reference](/api) explains each field, and `--help` on any command lists its flags. Every command also takes `--api-key`, `--api-url`, `--pretty` and `--table`.

```bash
rumoro keywords:create --term "driftwood" --kind brand --platforms github,hackernews,x
rumoro keywords:update kw_... --matching '{"excludedTerms":["beach","furniture"]}'
rumoro keywords:health kw_... --range 30d
rumoro groups:create --name "Northwind" --externalId client_42
rumoro filters:update --excludedRepos driftwood-dev/website
```

| Command | What it does | Flags |
| --- | --- | --- |
| `filters:get` | Get the workspace filters |  |
| `filters:update` | Update the workspace filters | `--excludedTerms`, `--excludedAuthors`, `--excludedRepos`, `--subreddits`, `--json` |
| `groups:create` | Create a group | `--name`, `--externalId`, `--context`, `--json` |
| `groups:delete <id>` | Delete a group |  |
| `groups:get <id>` | Get a group |  |
| `groups:list` | List groups | `--externalId` |
| `groups:update <id>` | Update a group | `--name`, `--externalId`, `--context`, `--json` |
| `keywords:create` | Create a keyword | `--term`, `--kind`, `--platforms`, `--context`, `--matching`, `--cap`, `--groupId`, `--reviewSources`, `--json` |
| `keywords:delete <id>` | Delete a keyword |  |
| `keywords:get <id>` | Get a keyword |  |
| `keywords:health <id>` | Check a keyword's health | `--range`, `--ai` |
| `keywords:list` | List keywords | `--q`, `--groupId`, `--kind`, `--status`, `--platform`, `--sort`, `--limit`, `--offset` |
| `keywords:update <id>` | Update a keyword | `--kind`, `--muted`, `--platforms`, `--context`, `--matching`, `--cap`, `--groupId`, `--reviewSources`, `--json` |