Skip to main content
PATCH
/
task-categories
/
{id}
Update a task category
curl --request PATCH \
  --url https://www.ruddr.io/api/workspace/task-categories/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "isActive": true
}
'
{
  "id": "c7e2f4a1-9b38-4d65-8c17-3a5f1e2d4b96",
  "name": "Standard Task",
  "type": "standard",
  "icon": "file-alt",
  "color": "grey",
  "isActive": true,
  "isDefault": true,
  "createdAt": "2026-03-18T10:15:22.741Z"
}
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.

Path Parameters

​
id
string
required

The task category uuid.

Body

application/json
​
name
string

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

​
type
enum<string>

The type of the task category. Cannot be changed after tasks have been assigned to this 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. Cannot deactivate the default task category; set another task category as default first.

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.