SupportDeveloper ForumLogin
  • Overview
    • Introduction
    • Getting Started
    • Authentication
    • Error Handling
    • Pagination
    • Filtering
    • Ordering
    • Rate Limits
    • Permissions
    • Webhooks
    • MCP Server
    • Versioning
    • Changelog
    • Support
  • API v1 Reference
    • Projects Overview
    • Tasks Overview
    • Time Tracking Overview
    • Documents Overview
    • Search Overview
    • Companies Overview
    • Users Overview
    • Files & Images Overview
    • Custom Fields Overview
    • Workload & Planning Overview
    • Project Templates Overview
    • Login & Access Overview
    • API Management Overview
LogoLogo
SupportDeveloper ForumLogin
API v1 ReferenceTasks

POST
https://api.awork.com/api/v1/tasks/delete
POST
/api/v1/tasks/delete
1curl -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}'
Try it
1{}
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>
Was this page helpful?
Previous

Set the priority of the task with the specified id.

Next
Built with
Set the priority of the task with the specified id.
Deletes several tasks.

Headers

AuthorizationstringRequired
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

Errors

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

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.

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.