Skip to main content
POST
/
task-categories
Create a task category
curl --request POST \
  --url https://www.ruddr.io/api/workspace/task-categories \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "isActive": true
}
'
{
  "id": "a1b9d4e7-5c32-4f18-9a76-2e8f3d1c5b47",
  "name": "Milestone",
  "type": "standard",
  "icon": "rocket",
  "color": "teal",
  "isActive": true,
  "isDefault": false,
  "createdAt": "2026-04-10T16:42:18.293Z"
}
A classification applied to project tasks that determines their behavior. standard categories represent regular tasks, while rollup categories act as containers whose budgets and rollups derive from their descendant standard tasks.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required

The name of the task category (max 255 chars).

​
type
enum<string>
required

The type of the task category. Cannot be changed after tasks have been assigned to this category.

Available options:
standard,
rollup
​
icon
enum<string>
required

The icon identifier for the task category.

Available options:
check-circle,
folder,
tasks,
clipboard,
lightbulb,
rocket,
wrench,
file,
file-alt,
calendar,
users
​
color
enum<string>
required

The color identifier for the task category.

Available options:
grey,
grey-light,
teal,
teal-light,
blue,
blue-light,
orange,
orange-light,
brown,
brown-light,
purple,
purple-light
​
isActive
boolean

Whether the task category is active, defaults to true if not set.

Response

200

​
id
string

The unique identifier for the object.

​
name
string

The name of the task category.

​
type
enum<string>

The type of the task category.

Available options:
standard,
rollup
​
icon
enum<string>

The icon identifier for the task category.

Available options:
check-circle,
folder,
tasks,
clipboard,
lightbulb,
rocket,
wrench,
file,
file-alt,
calendar,
users
​
color
enum<string>

The color identifier for the task category.

Available options:
grey,
grey-light,
teal,
teal-light,
blue,
blue-light,
orange,
orange-light,
brown,
brown-light,
purple,
purple-light
​
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.