Feed & Notifications
User activity feed and notification management. The feed aggregates activity for the user and every team they belong to.
GET /api/users/{username}/feed
Get a user's activity feed, newest first: activity addressed to the user and to each team they belong to.
Authentication: Required
Permissions: A feed is personal. Only the user it belongs to and superusers can read it; anyone else gets 403. An unknown username answers 404.
Path Parameters:
| Parameter | Type | Description |
|---|---|---|
username | string | Username |
Query Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
start | integer | 0 | Page index |
size | integer | 30 | Items per page |
Response:
A paginated HAL collection under _embedded["inf:feed-item"].
{
"_links": {
"self": {
"href": "https://informer.example.com/api/users/admin/feed?start=0&size=10"
}
},
"start": 0,
"count": 0,
"total": 0,
"_embedded": {
"inf:feed-item": []
}
}
Use Case:
Display the user's activity stream and notifications.
GET /api/users/{username}/feed-new-count
Get the count of feed items since the user last marked the feed viewed.
Authentication: Required
Permissions: Only the user the feed belongs to and superusers; anyone else gets 403. An unknown username answers 404.
Response:
An object with a single count field.
{
"_links": {
"self": {
"href": "https://informer.example.com/api/users/admin/feed-new-count"
}
},
"count": 0
}
Use Case:
Display the notification badge count.
POST /api/users/{username}/_markFeedViewed
Stamp the user's last-viewed time so the new-item count resets to zero. Takes no request body, and marks the entire feed viewed. A user can only mark their own feed, even while impersonating.
Authentication: Required
[
1
]
Use Case:
Clear the notification badge when the user opens their activity.