Notifications
Notifications are the messages Productmind sends you, for example when someone mentions you or assigns you work. List yours, count the unread ones, and mark one or all of them as read. You can also post a workspace's activity to Slack channels: check the Slack connection, choose a channel and the events it receives, then pause, edit or remove it. See Profile and notifications.
List the calling user's notifications
Returns a paginated list of notifications for the authenticated user. Supports unreadOnly=true, workspaceId= and types= filters (types accepts repeated params or one comma-separated value); sorted by createdAt DESC by default.
query Parameters
pagelimitsortOrderunreadOnlyworkspaceIdtypesList the calling user's notifications › Responses
Paginated notifications
Get the unread-notifications count for the calling user
Returns { unread }. Optional workspaceId filter; otherwise covers every workspace. Optional types filter (repeated param or one comma-separated value) narrows the count to specific notification types without narrowing the list — the bell counts mentions only while still listing operational notifications.
query Parameters
workspaceIdtypesComma-separated notification types to count (e.g. mention.comment)
Get the unread-notifications count for the calling user › Responses
Unread count
Mark all the calling user's notifications as read
Marks every unread notification owned by the calling user as read. Optional workspaceId filter restricts the bulk-update to a single workspace.
Mark all the calling user's notifications as read › Request Body
workspaceIdIf set, only marks notifications for this workspace as read
Mark all the calling user's notifications as read › Responses
Bulk update result
List a workspace's chat-channel notification subscriptions
Returns every channel this workspace posts entity events to, with the event set each one receives and the last delivery error if there is one.
path Parameters
workspaceIdWorkspace UUID
List a workspace's chat-channel notification subscriptions › Responses
Channel subscriptions
Subscribe a chat channel to workspace events
Creates a subscription. The connector instance is resolved server-side from the workspace's live provider connection — it is never taken from the request. Fails when the provider is not connected or the channel already has a subscription.
path Parameters
workspaceIdWorkspace UUID
Subscribe a chat channel to workspace events › Request Body
providerChat provider, e.g. slack
channelIdProvider-native channel id (Slack: C0123ABCD, not the #name)
channelNameDisplay name cached for the settings list, without the leading #
eventsEvents this channel receives. At least one — an empty subscription is a deletion.
Subscribe a chat channel to workspace events › Responses
Created subscription
Update a chat-channel subscription
Changes the target channel, the event set, or the active flag. Any edit clears the recorded delivery error, since an edit is an attempt to fix it.
path Parameters
workspaceIdWorkspace UUID
subscriptionIdChannel subscription UUID
Update a chat-channel subscription › Request Body
channelIdchannelNameeventsisActiveUpdate a chat-channel subscription › Responses
Updated subscription
Connection and capability status for a chat provider
Reports whether the provider is connected, which scopes the install actually holds, which required scopes are missing, and whether direct messages can be delivered. grantedScopes: null means the install predates scope capture — treat it as unknown, not as empty. Pass ?refresh=1 to bypass the 5-minute cache after a reconnect.
path Parameters
workspaceIdWorkspace UUID
providerChat provider id, e.g. slack
query Parameters
refresh1 to bypass the status cache
Connection and capability status for a chat provider › Responses
Provider status
Channels available to post to for a chat provider
Backs the channel picker. Returns an empty list rather than an error when the provider is not connected, so the settings page renders without a provider round-trip failing it.
path Parameters
workspaceIdWorkspace UUID
providerChat provider id, e.g. slack
Channels available to post to for a chat provider › Responses
Available channels