Delete a task

DELETE

/public/v1/tasks/{id}

Permanently deletes a task. This is a hard delete: the task is removed and cannot be recovered. Returns 404 if no matching task exists in your company, and 403 if the authenticated user can't access it under their team restrictions. Responds 204 with no body on success.

Required permission: tasks_permissions_delete.

Authorization

Bearer

headerAuthorizationBearer <token>

API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.

Path Parameters

id*string

ID of the task to delete. An ID that doesn't exist for your company returns 404.

Response Body

No Content

Example Request

curl -X DELETE 'https://app.distru.com/public/v1/tasks/00000000-0000-0000-0000-00000000002d'

Example Request

curl -X DELETE 'https://app.distru.com/public/v1/tasks/00000000-0000-0000-0000-00000000002d'

Example Response

Empty

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Path Parameters

Response Body