Task

Tasks are children of lists.

Get Tasks for a List

GET a.wunderlist.com/api/v1/tasks

Params

name type notes
list_id integer required

Response

Status: 200

json
[
  {
    "id": 409233670,
    "assignee_id": 12345,
    "created_at": "2013-08-30T08:36:13.273Z",
    "created_by_id": 6234958,
    "due_date": "2013-08-30",
    "list_id": 123,
    "revision": 1,
    "starred": true,
    "title": "Hello"
  }
]

Get Completed Tasks

GET a.wunderlist.com/api/v1/tasks

Params

name type notes
completed boolean required
list_id integer required

Response

Status: 200

json
[
  {
    "id": 409233670,
    "assignee_id": 12345,
    "created_at": "2013-08-30T08:36:13.273Z",
    "created_by_id": 6234958,
    "due_date": "2013-08-30",
    "list_id": 123,
    "revision": 1,
    "starred": true,
    "title": "Hello",
    "completed_at": "2013-08-30T08:36:13.273Z",
    "completed_by_id": 123
  }
]

Get a specific task

GET a.wunderlist.com/api/v1/tasks/:id

Response

Status: 200

json
{
  "id": 409233670,
  "assignee_id": 12345,
  "created_at": "2013-08-30T08:36:13.273Z",
  "created_by_id": 6234958,
  "due_date": "2013-08-30",
  "list_id": 123,
  "revision": 1,
  "starred": true,
  "title": "Hello"
}

Create a task

POST a.wunderlist.com/api/v1/tasks

Data

name type notes
list_id integer required
title string required, maximum length is 255 characters
assignee_id integer
completed boolean
recurrence_type string valid options: "day", "week", "month", "year", must be accompanied by recurrence_count
recurrence_count integer must be >= 1, must be accompanied by recurrence_type
due_date string formatted as an ISO8601 date
starred boolean

Request body example

json
{
  "list_id": -12345,
  "title": "Hallo",
  "assignee_id": 123,
  "completed": true,
  "due_date": "2013-08-30",
  "starred": false
}

Response

Status 201

json
{
  "id": 409233670,
  "assignee_id": 123,
  "created_at": "2013-08-30T08:36:13.273Z",
  "created_by_id": 6234958,
  "due_date": "2013-08-30",
  "list_id": -12345,
  "revision": 1,
  "starred": false,
  "title": "Hello"
}

Update a task by overwriting properties

PATCH a.wunderlist.com/api/v1/tasks/:id

Data

name type notes
revision integer required
list_id integer can be given to move the Task into a different List
title string maximum length is 255 characters
assignee_id integer
completed boolean
recurrence_type string valid options: "day", "week", "month", "year", must be accompanied by recurrence_count
recurrence_count integer must be >= 1, must be accompanied by recurrence_type
due_date string formatted as an ISO8601 date
starred boolean
remove array[string] an array of attributes to delete from the task, e.g. 'due_date'

Request body example

json
{
  "revision": 999,
  "title": "Hallo",
  "completed": true,
  "due_date": "2013-08-30",
  "starred": false,
  "remove": ["assignee_id"]
}

Response

Status 200

json
{
  "id": 409233670,
  "created_at": "2013-08-30T08:36:13.273Z",
  "created_by_id": 6234958,
  "due_date": "2013-08-30",
  "list_id": -12345,
  "revision": 1001,
  "starred": false,
  "title": "Hello"
}

Delete a task

DELETE a.wunderlist.com/api/v1/tasks/:id

Params

name type notes
revision integer required

Response

Status 204
You can report issues or ask questions via our GitHub repository.