Skip to main content
POST
/
task-templates
Create a task template
curl --request POST \
  --url https://www.ruddr.io/api/workspace/task-templates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "taskCategoryId": "<string>",
  "budgetHours": 123,
  "notes": "<string>",
  "isBillable": true,
  "tagIds": [
    "<string>"
  ]
}
'
{
  "id": "3f8a2d1e-bc47-4e92-a5f6-d91c7e084b23",
  "name": "Consulting Meetings",
  "budgetHours": 40,
  "notes": "Standard consulting engagement setup tasks",
  "isBillable": true,
  "createdAt": "2025-11-20T16:09:46.218Z",
  "tags": [
    {
      "id": "791c3dc6-9f13-46d5-b9f2-3368fb70624e",
      "name": "Set-up"
    }
  ],
  "taskCategory": {
    "id": "c7e2f4a1-9b38-4d65-8c17-3a5f1e2d4b96",
    "name": "Standard Task",
    "type": "standard"
  }
}
A reusable task definition that can be quickly added to projects.

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 template. Max 255 characters.

taskCategoryId
string

The ID (uuid) of the task category to assign to this task template. Must reference a standard type task category. Defaults to the workspace's default task category if not provided.

budgetHours
number | null

The budget hours for the task template.

notes
string | null

Notes for the task template. Max 5,000 characters.

isBillable
boolean

Whether the task template is billable.

tagIds
string[]

The IDs of the task tags to associate with this task template.

Response

200

id
string

The unique identifier for the object.

name
string

The name of the task template.

budgetHours
number | null

The budget hours of the task template.

notes
string | null

Notes for the task template.

isBillable
boolean

Whether the task template is billable.

createdAt
string<date-time>

The timestamp when the object was created.

tags
object[]

The tags associated with the task template.

taskCategory
object

The task category associated with this task template.