Skip to main content

Feed & Notifications

User activity feed and notification management.

GET /api/users/{username}/feed​

Get user's activity feed.

Authentication: Required

Path Parameters:

ParameterTypeDescription
usernamestringUsername

Response:

{
  "_links": {
    "self": { "href": "/api/users/{username}/feed" }
  },
  "_embedded": {
    "inf:feed-item": [
      {
        "id": "activity-uuid",
        "type": "datasetCreated",
        "userId": "john.doe",
        "entityType": "dataset",
        "entityId": "sales-2024",
        "message": "Created dataset: Sales 2024",
        "viewed": false,
        "createdAt": "2024-02-09T10:00:00Z",
        "_links": {
          "inf:entity": { "href": "/api/datasets/sales-2024" }
        }
      }
    ]
  },
  "start": 0,
  "count": 1,
  "total": 1
}

Use Case:

Display user's activity stream and notifications.

GET /api/users/{username}/feed-new-count​

Get count of unread feed items.

Authentication: Required

Response:

{
  "count": 5
}

Use Case:

Display notification badge count.

POST /api/users/{username}/_markFeedViewed​

Mark feed items as viewed.

Authentication: Required

Request Body:

{
  "activityIds": ["activity-uuid-1", "activity-uuid-2"]
}

Response:

{
  "marked": 2
}

Use Case:

Clear notification badges when user views activity.