---
title: "Create an intent category"
method: POST
path: "/v1/environments/{environmentId}/intent-categories"
tags: ["insights"]
---

# Create an intent category

`POST /v1/environments/{environmentId}/intent-categories`

Create an intent category, optionally linking it to existing intents

## Path parameters

- `environmentId` string, required — The ID of the environment

## Request body

- object
  - `name` string, required — The category name
  - `color` 'red' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'gray' — The category color; derived from the name when omitted
  - `intentIds` string[] — IDs of intents to link to the new category

## Response `200`

The created intent category

- object
  - `id` string, required
  - `createdAt` string, date-time, required
  - `environmentId` string, required
  - `name` string, required
  - `color` 'red' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'gray', required

## Other responses

- `400` — 400
- `404` — 404

## Changes

- **2026-08-15** `262875478562` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/alpic/apis/alpic-api/changes/v1/environments/:environmentId/intent-categories/post.md)

---

[API](https://skmtc.dev/alpic/apis/alpic-api.md) · [All operations](https://skmtc.dev/alpic/apis/alpic-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alpic/alpic-api/revisions/262875478562/schema)