Deletes several tasks. | awork API

Required Permissions: The required permissions depend on the base type of the task. If the task is a project task, write permissions on the project-planning-data feature are required. For a user’s private task, no special permissions are required.

Returns 204 NoContent if all tasks have been deleted successfully. Returns 207 MultiStatus if at least one task could not be deleted, including the reasons.

Deletes the specified tasks. By default, the related time entries of these tasks loose the relation to the deleted tasks. In order to delete the time entires as well, you need to set the 'DeleteTimeTrackings' property to true. <Check><b>Required Permissions</b>: The required permissions depend on the base type of the task. If the task is a project task, `write` permissions on the `project-planning-data` feature are required. For a user's private task, no special permissions are required.</Check><Info>Returns `204 NoContent` if all tasks have been deleted successfully. Returns `207 MultiStatus` if at least one task could not be deleted, including the reasons.</Info>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

The model to delete tasks.

taskIdslist of stringsRequired

List of tasks to be deleted.

deleteTimeTrackingsbooleanOptional

Set to true to also delete the related time trackings. If it is set to false, the related time trackings will still be there, but the project and task reference will be cleared. This will also happen if no request body is present.

Response

No Content

1	curl -X POST https://api.awork.com/api/v1/tasks/delete \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"taskIds": [
6	"123e4567-e89b-12d3-a456-426614174000"
7	]
8	}'

Authentication

Request

Response

Errors