Task updated - Plain Docs

This event is fired when a task’s title, description, priority, company, tenant, or assignment changes. A status change fires both this event and task.task_status_transitioned.

Schema

View JSON Schema → Example:

{
  "timestamp": "2026-09-11T11:05:17.402Z",
  "workspaceId": "w_01GST0W989ZNAW53X6XYHAY87P",
  "payload": {
    "eventType": "task.task_updated",
    "previousTask": {
      "id": "ta_01HD45QK2VYX9P0S3R7T8AWCE1",
      "ref": "T-124",
      "title": "Check in after renewal",
      "description": "Renewal closed last week. Confirm the new plan works for them.",
      "status": "TODO",
      "priority": 3,
      "companyId": null,
      "tenantId": null,
      "assignee": null,
      "assignedAt": null,
      "sourceLinks": [],
      "createdAt": "2026-09-10T16:30:00.000Z",
      "createdBy": {
        "actorType": "user",
        "userId": "u_01H1V4NA10RMHWFBXB6A1ZBYRA"
      },
      "updatedAt": "2026-09-10T16:30:00.000Z",
      "updatedBy": {
        "actorType": "user",
        "userId": "u_01H1V4NA10RMHWFBXB6A1ZBYRA"
      },
      "deletedAt": null,
      "deletedBy": null
    },
    "task": {
      "id": "ta_01HD45QK2VYX9P0S3R7T8AWCE1",
      "ref": "T-124",
      "title": "Check in after renewal (escalated)",
      "description": "Renewal closed last week. Confirm the new plan works for them.",
      "status": "TODO",
      "priority": 1,
      "companyId": "co_01HD44FHDPG82VQ4QNHDR4N2T0",
      "tenantId": null,
      "assignee": {
        "id": "u_01H1V4NA10RMHWFBXB6A1ZBYRA",
        "email": "sam@example.com",
        "fullName": "Sam",
        "publicName": "Sam",
        "status": "ONLINE",
        "statusChangedAt": "2026-09-11T09:00:00.000Z",
        "createdAt": "2023-06-01T09:29:48.903Z",
        "createdBy": {
          "actorType": "user",
          "userId": "u_01H1V4NA10RMHWFBXB6A1ZBYRA"
        },
        "updatedAt": "2023-06-01T09:29:48.903Z",
        "updatedBy": {
          "actorType": "user",
          "userId": "u_01H1V4NA10RMHWFBXB6A1ZBYRA"
        },
        "deletedAt": null,
        "deletedBy": null
      },
      "assignedAt": "2026-09-11T11:05:17.402Z",
      "sourceLinks": [],
      "createdAt": "2026-09-10T16:30:00.000Z",
      "createdBy": {
        "actorType": "user",
        "userId": "u_01H1V4NA10RMHWFBXB6A1ZBYRA"
      },
      "updatedAt": "2026-09-11T11:05:17.402Z",
      "updatedBy": {
        "actorType": "user",
        "userId": "u_01H1V4NA10RMHWFBXB6A1ZBYRA"
      },
      "deletedAt": null,
      "deletedBy": null
    }
  },
  "id": "pEv_01HD4X8CVDKTQ4PHXENSAB7FGH",
  "webhookMetadata": {
    "webhookTargetId": "whTarget_01HD4400VTDJQ646V6RY37SR7K",
    "webhookTargetVersion": "2026-09-11",
    "webhookDeliveryAttemptId": "whAttempt_01HD4XJ0ZR6WYVTKS0Q1MC8N3F",
    "webhookDeliveryAttemptNumber": 1,
    "webhookDeliveryAttemptTimestamp": "2026-09-11T11:05:18.076Z"
  },
  "type": "task.task_updated"
}

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);
}