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