Tasks

• Get all tasks
• Get task
• Create task
• Update task
• Complete task
• Delete task

Get all tasks

GET v3/projects/23423233/todolists/13964085/tasks returns all tasks in the specified task list.

[
  {
    "ticket": "20842",
    "id": 985356917305,
    "title": "Task 1",
    "description": "Task description",
    "completed": false,
    "assigned": [
      8172598588
    ],
    "labels": [
      4766001983
    ],
    "sub_tasks": 0,
    "comments": 0,
    "project": {
      "id": 4469983073,
      "name": "Castle"
    },
    "stage": {
      "id": 6074498296,
      "name": "New"
    }
  }
]

Get task

GET v v3/projects/23423233/todolists/13964085/tasks/13966758 returns the specified task.

{
  "ticket": "29842",
  "id": 175398977305,
  "title": "Task 1",
  "description": "Task description",
  "completed": false,
  "assigned": [
    8172984588
  ],
  "labels": [
    4666981713
  ],
  "sub_tasks": 0,
  "comments": 0,
  "project": {
    "id": 4769703983,
    "name": "Castle"
  },
  "stage": {
    "id": 6074498296,
    "name": "New"
  }
}

Create task

POST v3/projects/23423233/todolists/13964085/tasks creates a new task.

Request Body

{
  "title": "Get it signed",
  "description": "Need to get it signed off immediately",
  "start_date": "2016-11-10",
  "due_date": "2016-11-10",
  "estimated_hours": 5,
  "estimated_mins": 30,
  "assigned": [
    12009183
  ],
  "labels": [
    12254912
  ]
}

The assigned array is optional and accepts People IDs. Labels are also optional.

200 OK is returned along with the created task.

Custom Fields Example

{
  "title": "Get it signed",
  "custom_fields": {
    "6768923873": {
      "value": "95"
    },
    "6798922309": {
      "value": ["740974745"]
    }
  }
}

Attachments Example

{
  "title": "Get it signed",
  "attachments": [
    {
      "id": "123456",
      "folder": 0
    }
  ]
}

Attachment IDs are obtained from the Attachments API before creating a task with files.

Update task

PUT v3/projects/23423233/todolists/13964085/tasks/13966758 updates an existing task.

{
  "description": "Get it signed off",
  "start_date": "2013-12-31",
  "due_date": "2013-12-31"
}

200 OK is returned along with the updated task.

Complete task

Use the same update endpoint to mark a task as completed.

{
  "completed": true
}

Pass false to mark the task as incomplete.

Delete task

DELETE v3/projects/23423233/todolists/13964085/tasks/13966758 deletes the specified task.

204 No Content is returned if the task is deleted successfully. 403 Forbidden is returned if access is denied.