Delete Task

Overview

This endpoint permanently removes a task from StrikeOff. Unlike archiving, deletion is irreversible - the task and all its associated data (comments, checklists, attachments, assignment history) will be completely removed from the database. Use this only when you are certain the task should be permanently destroyed. For tasks you might need later, consider using the update endpoint to set archived:true instead, which hides the task but preserves all its data. Note: Tasks created via the external API can be deleted through this endpoint, maintaining sync with your external system when items are removed there.

When to Use This

• Removing a task that was created by mistake
• Cleaning up test tasks created during integration development
• Deleting tasks when the corresponding item is permanently deleted in your external system
• Removing spam or invalid tasks that should not exist

Path Parameters

Request Example

curl -X DELETE "https://strikeoffapp.com/api/external/v1/tasks/cltask001" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

{
  "success": true,
  "data": {
    "message": "Task deleted successfully"
  }
}

Notes

• This action is permanent and cannot be undone.
• All task data including comments, checklists, and attachments will be deleted.
• Consider using the update endpoint to archive tasks instead if you want to preserve data.
• Returns 404 if the task does not exist or is not accessible.