---
title: "Create a task template"
method: POST
path: "/task-templates"
tags: ["Task Templates"]
---

# Create a task template

`POST /task-templates`

## Request

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

## Request body

- object
  - `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, nullable: The budget hours for the task template.
  - `notes` string, nullable: 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`

200

- TaskTemplate
  - `id` string: The unique identifier for the object.
  - `name` string: The name of the task template.
  - `budgetHours` number, nullable: The budget hours of the task template.
  - `notes` string, nullable: 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.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the tag.
  - `taskCategory` object: The task category associated with this task template.
    - `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.

## 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)