POST/projects/{id}/tasklists.json

Create Task List

Creates a new task list based on the submitted JSON or XML data. If you wish to base the new list on a task list template that you’ve created previously, you can specify the todo-list-template-id field in the data, and the new list will default to the name, description, and tasks indicated by that template.

Checkout our Teamwork.com code sample repo on GitHub for example an Add tasklist from a template code sample

Additional notes:

Task List Template Options

When you're creating the tasklist using a todo-list-template-id you can pass the following:
  • todo-list-template-id
  • todo-list-template-start-date (Blank or YYYYMMDD format e.g: 20150314)
  • todo-list-template-keep-off-weekends (Boolean: default false)
  • todo-list-template-assignments (Blank or struct): The format of the todo-list-template-assignments struct should be the defined role name in creation of the Task List Template, and the value being a comma separated list of user-ids to assign the task to.

Additonal Options

You can pass 'addToTop:true' to force the new item to the top of the tasklists list. The default is false which adds the item to the bottom of the list of tasklists.

Path Params

  • Name
    id
    Type
    string
    required
    Description

Body Params

    • Name
      applyDefaultsToExistingTasks
      Type
      boolean
      Description
      Will over ride existing tasks in the task list with these new defaults.
    • Name
      todo-list
      Type
      object

    Responses

    • Code
      201
      Type
      object
      Schema
      Description
      201 Response

    Examples

    201 Response

    application/json
    {
      "TASKLISTID": "1234",
      "STATUS": "OK"
    }