---
title: "Create a task category"
method: POST
path: "/task-categories"
tags: ["Task Categories"]
---

# Create a task category

`POST /task-categories`

## Request

- Base URL: `https://www.ruddr.io/api/workspace`
- URL: `https://www.ruddr.io/api/workspace/task-categories`
- Auth: HTTP bearer

## Request body

- object
  - `name` string, required: The name of the task category (max 255 chars).
  - `type` 'standard' | 'rollup' | 'milestone', required: The type of the task category. Cannot be changed after tasks have been assigned to this category.
  - `icon` 'check-circle' | 'folder' | 'tasks' | 'clipboard' | 'lightbulb' | 'rocket' | 'wrench' | 'file' | 'file-alt' | 'calendar' | 'users', required: The icon identifier for the task category.
  - `color` 'grey' | 'grey-light' | 'teal' | 'teal-light' | 'blue' | 'blue-light' | 'orange' | 'orange-light' | 'brown' | 'brown-light' | 'purple' | 'purple-light', required: The color identifier for the task category.
  - `isActive` boolean: Whether the task category is active, defaults to `true` if not set.

## Response `200`

200

- TaskCategory
  - `id` string: The unique identifier for the object.
  - `name` string: The name of the task category.
  - `type` 'standard' | 'rollup' | 'milestone': The type of the task category.
  - `icon` 'check-circle' | 'folder' | 'tasks' | 'clipboard' | 'lightbulb' | 'rocket' | 'wrench' | 'file' | 'file-alt' | 'calendar' | 'users': The icon identifier for the task category.
  - `color` 'grey' | 'grey-light' | 'teal' | 'teal-light' | 'blue' | 'blue-light' | 'orange' | 'orange-light' | 'brown' | 'brown-light' | 'purple' | 'purple-light': The color identifier for the task category.
  - `isActive` boolean: Whether the task category is active.
  - `isDefault` boolean: Whether this is the default task category for the workspace.
  - `createdAt` string, date-time: The timestamp when the object was created.

## Other responses

- `400`: 400
- `409`: 409

---

[API](https://skmtc.dev/ruddr/apis/ruddr-api.md) · [All operations](https://skmtc.dev/ruddr/apis/ruddr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruddr/apis/ruddr-api/revisions/01c3f2a969ba?raw)