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

> Create an intent category in an Alpic environment

Create an intent category, optionally linking it to existing intents.

## Usage

```bash theme={null}
alpic insights category create
```

Prompts for a name and creates the category in the environment from the local `.alpic` configuration.

## Extended Usage

Create a category with an explicit name and color:

```bash theme={null}
alpic insights category create --name Scheduling --color blue
```

When `--color` is omitted, a color is derived from the category name. Available colors: `red`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `gray`.

Link the new category to existing intents right away:

```bash theme={null}
alpic insights category create \
  --name Scheduling \
  --intent-id <intentId> \
  --intent-id <intentId>
```

Create in automation and print the created category:

```bash theme={null}
alpic insights category create --environment-id <environmentId> --name Scheduling --json --non-interactive
```

<Info>`--name` is required in non-interactive mode.</Info>

## 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 | |
| `--name` | The category name | |
| `--color` | The category color; derived from the name when omitted | |
| `--intent-id` | Link the new category to this intent ID. Repeatable. | |
| `--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>


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