Task deleted - Plain Docs

This event is fired when a task is deleted. The payload contains previousTask, the deleted row, with deletedAt and deletedBy populated.

Schema

View JSON Schema → Example:

{
  "timestamp": "2026-09-11T17:22:49.930Z",
  "workspaceId": "w_01GST0W989ZNAW53X6XYHAY87P",
  "payload": {
    "eventType": "task.task_deleted",
    "previousTask": {
      "id": "ta_01HD46X7F1QMZK9D2SNCJ0RTB4",
      "ref": "T-125",
      "title": "Draft Q3 onboarding checklist",
      "description": null,
      "status": "TODO",
      "priority": 3,
      "companyId": null,
      "tenantId": null,
      "assignee": null,
      "assignedAt": null,
      "sourceLinks": [],
      "createdAt": "2026-09-08T10:15:00.000Z",
      "createdBy": {
        "actorType": "user",
        "userId": "u_01H1V4NA10RMHWFBXB6A1ZBYRA"
      },
      "updatedAt": "2026-09-08T10:15:00.000Z",
      "updatedBy": {
        "actorType": "user",
        "userId": "u_01H1V4NA10RMHWFBXB6A1ZBYRA"
      },
      "deletedAt": "2026-09-11T17:22:49.930Z",
      "deletedBy": {
        "actorType": "user",
        "userId": "u_01H1V4NA10RMHWFBXB6A1ZBYRA"
      }
    }
  },
  "id": "pEv_01HD4X9DWEMVR5KFYPT2GBH8XC",
  "webhookMetadata": {
    "webhookTargetId": "whTarget_01HD4400VTDJQ646V6RY37SR7K",
    "webhookTargetVersion": "2026-09-11",
    "webhookDeliveryAttemptId": "whAttempt_01HD4XK3NF7RXQZTM90WCE5YAB",
    "webhookDeliveryAttemptNumber": 1,
    "webhookDeliveryAttemptTimestamp": "2026-09-11T17:22:50.611Z"
  },
  "type": "task.task_deleted"
}

Using the Webhooks SDK

You can use the @team-plain/webhooks package to parse and verify this event with full type safety:

import { verifyPlainWebhook } from "@team-plain/webhooks";

const result = verifyPlainWebhook(rawBody, signature, secret);

if (result.error) {
  console.error(result.error.message);
} else {
  // result.data is fully typed with the event payload
  const event = result.data;
  console.log(event.eventType, event.payload);
}