Notification types
feedEvent
Fired when an event-feed card is created or changes — it grew, moved to the bottom, or someone reacted.
Delivered as the
notification socket event with type set to feedEvent.Fired when an event-feed card is created or changes — it grew, moved to the bottom, or someone reacted.
Sent on project/{projectId}/{visibility} only — the creator and reviewer feeds never share a card. Carries the whole card; clients upsert it by id and re-sort by lastActivityAt.
Payload for the feedEvent event.
Payload
| Property | Type | Required | Description |
|---|---|---|---|
type | string | yes | The specific type of notification event (matches the top-level key, e.g., 'workspaceCreate'). Every value in notificationTemplates (config/notifications.js) is documented in this tag. |
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 |
tokens
| Property | Type | Required | Description |
|---|---|---|---|
event | object | yes | The whole serialized card — the same FeedEvent shape GET /v1/projects/{projectId}/feed-events/{visibility} returns. |