Skip to main content

Activity Feed API

Read-only activity feed over the audit trail with follow/unfollow management for personalized feeds.

Endpoints Overview

MethodEndpointDescription
GET/spaces/{slug}/activity-feedSpace activity feed
GET/spaces/{slug}/activity-feed/highlightsWeekly highlights
GET/activity-feed/personalPersonal feed
POST/activity-feed/followingFollow resource
DELETE/activity-feed/following/{id}Unfollow resource
GET/activity-feed/followingList followings

Space Activity Feed

GET /spaces/{slug}/activity-feed

Query Parameters

ParameterTypeDescription
event_typestringFilter by action type
resource_typestringFilter by resource type
skipintegerPagination offset
limitintegerPage size

Response

[
{
"id": "...",
"user": { "id": "...", "email": "alice@example.com", "full_name": "Alice" },
"action": "create",
"resource_type": "product",
"resource_id": "...",
"resource_name": "Customer Events",
"created_at": "2026-01-15T10:30:00Z"
}
]

Weekly Highlights

GET /spaces/{slug}/activity-feed/highlights
ParameterTypeDescription
daysintegerLook-back window (1–90, default 7)

Returns top contributors, new dataset counts, and quality check pass/fail rates.


Personal Feed

GET /activity-feed/personal

Returns events for resources the current user follows.


Follow / Unfollow

POST /activity-feed/following
{
"resource_type": "product",
"resource_id": "..."
}
DELETE /activity-feed/following/{following_id}

Error Responses

StatusDescription
404Following not found