Activity API¶

The Activity API exposes a real-time activity feed derived from the audit log. It powers the dashboard activity stream and supports filtering by action, entity type, user, and time range.

List Activity¶

GET /api/v1/activity

Query Parameters¶

Parameter	Type	Default	Description
`limit`	integer	20	Maximum items to return (1-100)
`offset`	integer	0	Offset for pagination
`entity_type`	string	-	Filter by entity/table name (e.g., `workbook`)
`action`	string	-	Audit action filter (e.g., `workbook.upload`, `calculation.complete`)
`user_id`	string (UUID)	-	Filter by actor user ID
`start_date`	string (ISO 8601)	-	Filter events created at or after this timestamp
`end_date`	string (ISO 8601)	-	Filter events created at or before this timestamp

Example¶

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.calcbridge.io/api/v1/activity?limit=10&action=workbook.upload"

Response¶

{
  "items": [
    {
      "id": "event-1",
      "action": "workbook.upload",
      "type": "upload",
      "status": "success",
      "description": "Workbook uploaded • CLO_2026_Q1.xlsx",
      "entity_type": "workbook",
      "entity_id": "550e8400-e29b-41d4-a716-446655440000",
      "entity_name": "CLO_2026_Q1.xlsx",
      "user_id": "7d13f5d0-9bd0-4d18-9ac1-4c8d0505c7b0",
      "created_at": "2026-02-18T10:45:00Z"
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0
}

Notes¶

Activity entries are derived from the immutable audit_log table and respect tenant isolation.
Use action filters to build focused feeds (e.g., calculation-only or export-only streams).