Person management
Journal management
API documentation
Account management
Persons
Journal
Task categories
Table of contents
This endpoint lets you manage the task categories in your account.
Task categories help you organize and classify different types of tasks. Each category can have a name and a color to help visually distinguish them.
The Task category object
This object represents a category of tasks.
Attributes
The ID of the task category.
The object type. Always 'task_category'.
The name of the task category.
The color of the task category.
The date and time the object was created, in Unix timestamp format.
The date and time the object was last updated, in Unix timestamp format.
{
"id":
4
,
"object":
"task_category"
,
"name":
"Personal"
,
"color":
"#FF0000"
,
"created_at":
1715145600
,
"updated_at":
1715145600
}
Get the list of task categories
This endpoint gets the list of task categories in the account.
This call is not paginated, since there should not be too many task categories in the account.
URL parameters
No URL parameters are required for this endpoint.
Query parameters
No query parameters are available for this endpoint.
Response attributes
The ID of the task category.
The object type. Always 'task_category'.
The name of the task category.
The color of the task category.
The date and time the object was created, in Unix timestamp format.
The date and time the object was last updated, in Unix timestamp format.
{
"data": [
{
"id":
4
,
"object":
"task_category"
,
"name":
"Personal"
,
"color":
"#FF0000"
,
"created_at":
1715145600
,
"updated_at":
1715145600
}
]
}
Create a new task category
This endpoint creates a new task category. It will return the task category in the response.
URL parameters
No URL parameters are required for this endpoint.
Query parameters
The name of the task category. Maximum 255 characters.
The color of the task category. Maximum 30 characters.
Response attributes
The ID of the task category.
The object type. Always 'task_category'.
The name of the task category.
The color of the task category.
The date and time the object was created, in Unix timestamp format.
The date and time the object was last updated, in Unix timestamp format.
{
"data": {
"id":
4
,
"object":
"task_category"
,
"name":
"Personal"
,
"color":
"#FF0000"
,
"created_at":
1715145600
,
"updated_at":
1715145600
}
}
Update a task category
This endpoint updates a task category. It will return the task category in the response.
URL parameters
The ID of the task category to update.
Query parameters
The name of the task category. Maximum 255 characters.
The color of the task category. Maximum 30 characters.
Response attributes
The ID of the task category.
The object type. Always 'task_category'.
The name of the task category.
The color of the task category.
The date and time the object was created, in Unix timestamp format.
The date and time the object was last updated, in Unix timestamp format.
{
"data": {
"id":
4
,
"object":
"task_category"
,
"name":
"Personal"
,
"color":
"#FF0000"
,
"created_at":
1715145600
,
"updated_at":
1715145600
}
}
Delete a task category
This endpoint deletes a task category. It will return a 204 No Content response.
URL parameters
The ID of the task category to delete.
Query parameters
No query parameters are available for this endpoint.
Response attributes
This endpoint returns a 204 No Content response with no body.
204 No Content
Please login to vote.
It's free and will help us improve the page.
Taylor will be proud of you.
Last updated on April 5, 2025.