Notification types
boardDelete
Fired when a kanban board is deleted.
Delivered as the
notification socket event with type set to boardDelete.Fired when a kanban board is deleted. Cascaded task deletions / reassignments are included in changes.
Payload for the boardDelete event.
Token keys marked with (*) will be deprecated in a future release and should not be used for new development; replace them with the values and objects in the changes key in existing implementations.
Payload
| Property | Type | Required | Description |
|---|---|---|---|
type | string | yes | The specific type of notification event (matches the top-level key, e.g., 'workspaceCreate'). Every notification type is documented as its own event in this reference. |
initiatorId | string (uuid) | no | ID of the user or system that initiated the event. Null if initiatorType is 'system'. |
initiatorType | "user" | "system" | yes | Type of initiator (user or system). |
initiator | object | null | no | Populated initiator user object (if initiatorType is 'user'). |
resourceId | string (uuid) | yes | ID of the primary resource this notification pertains to. |
resourceType | string | yes | Type of the primary resource this notification pertains to. |
channels | string[] | no | The specific channels this notification was published on. Present on notification objects returned by the REST API only; the socket 'notification' payload omits it (and id). |
createdAt | string (date-time) | yes | Timestamp when the notification was created. |
tokens | object | no | |
changes | object | no | changes.delete always contains the board plus one entry per task deleted with it; changes.update (present only when tasks were moved to another board) lists the reassigned tasks without a resource object. |
tokens
| Property | Type | Required | Description |
|---|---|---|---|
(*)projectId | string (uuid) | no | Deprecated. |
boardName | string | yes |
changes
| Property | Type | Required | Description |
|---|---|---|---|
update | object[] | no | |
delete | object | object[] | no |
update (items)
| Property | Type | Required | Description |
|---|---|---|---|
resourceId | string (uuid) | no | ID of a task reassigned to another board/column. |
resourceType | "task" | no |
delete (items)
One of 2 variants:
Variant 1
| Property | Type | Required | Description |
|---|---|---|---|
resourceId | string (uuid) | no | |
resourceType | "board" | no |
Variant 2
| Property | Type | Required | Description |
|---|---|---|---|
resourceId | string (uuid) | no | ID of a task deleted with the board. |
resourceType | "task" | no |