Nurama Developers
Notification types

userFeed

Fired when an item in someone's user feed changes — a card placed or moved, an action item recorded, settled, removed or cleared.

Delivered as the notification socket event with type set to userFeed.

Fired when an item in someone's user feed changes — a card placed or moved, an action item recorded, settled, removed or cleared.

Sent on the user/{userId} channel of every person the change affects, with one payload for all of them. It names the item by kind + subjectKey (unique within one person's feed) rather than by entry id. Clients apply it to what they hold and refetch GET /v1/users/feed for anything they don't; a missed event only delays the feed, since the next fetch is complete.

Payload for the userFeed event.

Payload

PropertyTypeRequiredDescription
typestringyesThe 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.
initiatorIdstring (uuid)noID of the user or system that initiated the event. Null if initiatorType is 'system'.
initiatorType"user" | "system"yesType of initiator (user or system).
initiatorobject | nullnoPopulated initiator user object (if initiatorType is 'user').
resourceIdstring (uuid)yesID of the primary resource this notification pertains to.
resourceTypestringyesType of the primary resource this notification pertains to.
channelsstring[]noThe 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).
createdAtstring (date-time)yesTimestamp when the notification was created.
tokensobjectno

tokens

PropertyTypeRequiredDescription
itemobjectyes

item

PropertyTypeRequiredDescription
change"placed" | "state" | "removed" | "cleared"yesplaced — new, or moved to the top (lastActivityAt). state — its state changed. removed — it is gone. cleared — every open action item up to before was dismissed.
category"activity" | "action"yes
kindstringno
subjectKeystringno
subjectKeysstring[]noIn place of subjectKey when several items of one kind changed state at once.
state"open" | "done" | "dismissed"no
feedEventIdstringnoThe card, for activity items.
projectIdstringno
visibilitystringno
lastActivityAtinteger (int64)no
beforeinteger (int64)noFor cleared.

On this page