Stats Notifier

List current stats notification subscriptions and their time windows

{
  "data": [
    {
      "notification_id": "notif_001",
      "user_id": "usr_4f8a2c",
      "time_window": "quarterly",
      "status": "active",
      "last_refreshed_at": "2026-03-26T09:45:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

Get a specific stats notification subscription

{
  "notification_id": "notif_001",
  "user_id": "usr_4f8a2c",
  "time_window": "quarterly",
  "status": "active",
  "last_refreshed_at": "2026-03-26T09:45:00Z",
  "snapshot": {
    "total_activities": 47,
    "completed_activities": 42,
    "hours_logged": 128.5
  }
}

Build and activate a stats notification subscription for a user and time window

{
  "user_id": "usr_4f8a2c",
  "time_window": "quarterly"
}

{
  "notification_id": "notif_002",
  "user_id": "usr_4f8a2c",
  "time_window": "quarterly",
  "status": "active",
  "snapshot": {
    "total_activities": 47,
    "completed_activities": 42,
    "hours_logged": 128.5
  },
  "created_at": "2026-03-26T10:00:00Z"
}

Change the time window for an active stats notification subscription

{
  "time_window": "monthly"
}

{
  "notification_id": "notif_001",
  "user_id": "usr_4f8a2c",
  "time_window": "monthly",
  "status": "active",
  "updated_at": "2026-03-26T10:02:00Z"
}

Deactivate and remove a stats notification subscription

{
  "deleted": true,
  "notification_id": "notif_001"
}

Trigger an immediate stats refresh for an active notification subscription

{
  "notification_id": "notif_001",
  "refreshed": true,
  "refreshed_at": "2026-03-26T10:05:00Z",
  "snapshot": {
    "total_activities": 49,
    "completed_activities": 44,
    "hours_logged": 133
  }
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}