Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Daniel-Stojanovski/finkiopendesk/llms.txt

Use this file to discover all available pages before exploring further.

Returns all notification groups belonging to a specific user. Each group corresponds to a context that generated activity — typically a discussion thread — and contains one or more individual notification events. The response includes a precomputed unreadCount per group so clients can render unread badges without iterating over every event.
This endpoint is publicly accessible. No Authorization header is required; however, it returns user-specific data, so callers must supply the correct userId.

Request

GET https://finkiopendesk-be.onrender.com/api/notifications/{userId}

Path parameters

userId
string
required
The UUID of the user whose notifications to retrieve (e.g., a1b2c3d4-e5f6-7890-abcd-ef1234567890). The value is parsed as a UUID on the server; passing a non-UUID string returns a 400 Bad Request.

Response

Returns an array of NotificationGroupDto objects. The array is empty when the user has no notifications.
notificationGroupId
string
Unique identifier for the notification group (UUID v4).
title
string
Human-readable title for the group, typically the subject or discussion name that triggered the notifications.
type
string
The kind of context that produced this group (e.g., "COMMENT").
contextId
string
Identifier of the entity that this group is scoped to — for example, the discussion thread ID. Use this to navigate the user to the relevant content.
unreadCount
number
Number of events within this group that have not yet been marked as read. Derived server-side from the event list; not stored as a separate column.
events
NotificationEventDto[]
Ordered list of individual notification events belonging to this group.
Notifications are generated when another user interacts with content you have participated in — for example, when someone posts a new comment in a discussion thread you have previously commented on.

Example

curl -X GET \
  "https://finkiopendesk-be.onrender.com/api/notifications/a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Build docs developers (and LLMs) love