Activity Feed API
Read-only activity feed over the audit trail with follow/unfollow management for personalized feeds.
Endpoints Overview
| Method | Endpoint | Description |
|---|---|---|
| GET | /spaces/{slug}/activity-feed | Space activity feed |
| GET | /spaces/{slug}/activity-feed/highlights | Weekly highlights |
| GET | /activity-feed/personal | Personal feed |
| POST | /activity-feed/following | Follow resource |
| DELETE | /activity-feed/following/{id} | Unfollow resource |
| GET | /activity-feed/following | List followings |
Space Activity Feed
GET /spaces/{slug}/activity-feed
Query Parameters
| Parameter | Type | Description |
|---|---|---|
event_type | string | Filter by action type |
resource_type | string | Filter by resource type |
skip | integer | Pagination offset |
limit | integer | Page 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
| Parameter | Type | Description |
|---|---|---|
days | integer | Look-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
| Status | Description |
|---|---|
404 | Following not found |