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

# insights category update

> Rename or recolor an intent category

Rename or recolor an intent category.

## Usage

```bash theme={null}
alpic insights category update --name "New name"
```

Prompts for the category to update in the environment from the local `.alpic` configuration.

## Extended Usage

Select the category explicitly and change both fields:

```bash theme={null}
alpic insights category update \
  --category-id <categoryId> \
  --name "New name" \
  --color green
```

Update in automation:

```bash theme={null}
alpic insights category update \
  --environment-id <environmentId> \
  --category-id <categoryId> \
  --color green \
  --non-interactive
```

<Note>At least one of `--name` or `--color` is required. `--category-id` is required in non-interactive mode.</Note>

## Options

| Flag                 | Description                               | Default |
| -------------------- | ----------------------------------------- | ------- |
| `--environment-id`   | Select an environment by ID               |         |
| `--environment-name` | Select an environment by name             |         |
| `--project-id`       | Provide the project context by ID         |         |
| `--project-name`     | Provide the project context by name       |         |
| `--category-id`      | The ID of the intent category             |         |
| `--name`             | The new category name                     |         |
| `--color`            | The new category color                    |         |
| `--json`             | Print the unmodified API response as JSON | `false` |
| `--non-interactive`  | Skip interactive prompts                  |         |

<Tip>When the current directory is linked to an environment, the environment and project flags can be omitted.</Tip>