DELETE /tasks
Description
Deletes data on a task and returns an empty json object
The route handles the DELETE request made to the /tasks/{id} or /tasks path.
One or multiple tasks can be deleted in one request. All child tasks, if any, are also deleted.
| HTTP method | Route | Query parameter |
|---|---|---|
| DELETE | /tasks | id |
Query parameters
The ID of a task that should be removed is sent in the request line.
| Name | Type | Description |
|---|---|---|
id | number | Optional. The ID of a task to be removed. |
Payload
The server needs to receive a json object with one property:
| Name | Type | Description |
|---|---|---|
batch | array | Optional. The list of task IDs to be removed. |
Example:
{
"batch": [1, 2, 3]
}
Response
The route returns an empty json object in case of a successful request.
The HTTP status code shows whether the request succeeds (response.status == 200) or fails (response.status == 500).
Change log: The batch payload was added in v1.3
Related articles: