Productmind API

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

GET
https://api.productmind.ai
/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.

List the calling user's notifications › query Parameters

page
​number
limit
​number
sortOrder
​string · enum
Enum values:
asc
desc
unreadOnly
​boolean
workspaceId
​string
types
​string[]

List the calling user's notifications › Responses

200

Paginated notifications

​NotificationDTO[] · required

Get the unread-notifications count for the calling user

GET
https://api.productmind.ai
/notifications/unread-count

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.

Get the unread-notifications count for the calling user › query Parameters

workspaceId
​string
types
​string

Comma-separated notification types to count (e.g. mention.comment)

Get the unread-notifications count for the calling user › Responses

200

Unread count

​UnreadNotificationsCountDTO · required

Mark a single notification as read

POST
https://api.productmind.ai
/notifications/{id}/read

Marks the notification owned by the calling user as read. 404 if it does not exist or does not belong to the user.

Mark a single notification as read › path Parameters

id
​string · required

Notification UUID

Mark a single notification as read › Responses

200

Marked as read

data
​string · required

Mark all the calling user's notifications as read

POST
https://api.productmind.ai
/notifications/read-all

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

workspaceId
​string

If set, only marks notifications for this workspace as read

Mark all the calling user's notifications as read › Responses

200

Bulk update result

​object · required

List a workspace's chat-channel notification subscriptions

GET
https://api.productmind.ai
/workspaces/{workspaceId}/notification-channels/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.

List a workspace's chat-channel notification subscriptions › path Parameters

workspaceId
​string · required

Workspace UUID

List a workspace's chat-channel notification subscriptions › Responses

200

Channel subscriptions


Subscribe a chat channel to workspace events

POST
https://api.productmind.ai
/workspaces/{workspaceId}/notification-channels/subscriptions

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.

Subscribe a chat channel to workspace events › path Parameters

workspaceId
​string · required

Workspace UUID

Subscribe a chat channel to workspace events › Request Body

provider
​string · enum · required

Chat provider, e.g. slack

Enum values:
slack
channelId
​string · minLength: 1 · maxLength: 128 · required

Provider-native channel id (Slack: C0123ABCD, not the #name)

channelName
​string · minLength: 1 · maxLength: 255 · required

Display name cached for the settings list, without the leading #

events
​string[] · minItems: 1 · required

Events this channel receives. At least one — an empty subscription is a deletion.

Enum values:
feature.created
feature.created_bulk
feature.updated
feature.status_changed
feature_request.created
feature_request.updated
feature_request.status_changed
feature_request.promoted

Subscribe a chat channel to workspace events › Responses

Created subscription


Remove a chat-channel subscription

DELETE
https://api.productmind.ai
/workspaces/{workspaceId}/notification-channels/subscriptions/{subscriptionId}

Remove a chat-channel subscription › path Parameters

workspaceId
​string · required

Workspace UUID

subscriptionId
​string · required

Channel subscription UUID

Remove a chat-channel subscription › Responses

200

Subscription removed

No data returned

Update a chat-channel subscription

PATCH
https://api.productmind.ai
/workspaces/{workspaceId}/notification-channels/subscriptions/{subscriptionId}

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.

Update a chat-channel subscription › path Parameters

workspaceId
​string · required

Workspace UUID

subscriptionId
​string · required

Channel subscription UUID

Update a chat-channel subscription › Request Body

channelId
​string · minLength: 1 · maxLength: 128
channelName
​string · minLength: 1 · maxLength: 255
events
​string[] · minItems: 1
Enum values:
feature.created
feature.created_bulk
feature.updated
feature.status_changed
feature_request.created
feature_request.updated
feature_request.status_changed
feature_request.promoted
isActive
​boolean

Update a chat-channel subscription › Responses

200

Updated subscription


Connection and capability status for a chat provider

GET
https://api.productmind.ai
/workspaces/{workspaceId}/notification-channels/providers/{provider}/status

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.

Connection and capability status for a chat provider › path Parameters

workspaceId
​string · required

Workspace UUID

provider
​string · required

Chat provider id, e.g. slack

Connection and capability status for a chat provider › query Parameters

refresh
​string

1 to bypass the status cache

Connection and capability status for a chat provider › Responses

200

Provider status


Channels available to post to for a chat provider

GET
https://api.productmind.ai
/workspaces/{workspaceId}/notification-channels/providers/{provider}/channels

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.

Channels available to post to for a chat provider › path Parameters

workspaceId
​string · required

Workspace UUID

provider
​string · required

Chat provider id, e.g. slack

Channels available to post to for a chat provider › Responses

200

Available channels

​NotificationChannelTargetDTO[] · required