Creates a new task list. — awork API

To create a new project task list, the user needs manage permissions on the project-planning-data feature. For a private task list no permissions are required.

Path parameters

projectIdstringRequired

The id of the project.

Request

This endpoint expects an object.

namestringRequired>=1 character

The name of the list.

isHiddenForConnectUsersbooleanOptional

True if the task in this list will be not visible for external workspace users. False otherwise. If null, no change will be made.

orderdoubleOptional

The order of the list.

Response

idstringOptional

The id of the task list.

isArchivedbooleanOptional

Whether the task list has been archived.

createdOndatetimeOptional

The date this task list was created.

createdBystringOptional

The id of the user who created this task list.

updatedOndatetimeOptional

The date this task list was last modified.

updatedBystringOptional

The id of the user who last modified this task list.

namestringOptional

The name of the list.

orderdoubleOptional

The order of the list.

isHiddenForConnectUsersbooleanOptional

True if the task in this list will be not visible for external workspace users. False otherwise.

1	curl -X POST https://api.awork.com/api/v1/projects/projectId/tasklists \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"name": "Product and Marketing To-Dos"
6	}'

1	{
2	"id": "123e4567-e89b-12d3-a456-426614174000",
3	"isArchived": false,
4	"createdOn": "2021-03-22T15:00:00Z",
5	"createdBy": "123e4567-e89b-12d3-a456-426614174000",
6	"updatedOn": "2021-03-22T16:30:00Z",
7	"updatedBy": "123e4567-e89b-12d3-a456-426614174000",
8	"name": "Product and Marketing To-Dos",
9	"order": 2,
10	"isHiddenForConnectUsers": true
11	}