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.

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"
    }