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

namestring 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.

isActiveboolean

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

Response

200

idstring

The unique identifier for the object.

namestring

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.

isActiveboolean

Whether the task category is active.

isDefaultboolean

Whether this is the default task category for the workspace.

createdAtstring date-time

The timestamp when the object was created.

Example response

{
  "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"
}

Changes

No recorded changes to this operation across all 1 revision of this API.