Skip to content
Back to blog
Guides4 min readApril 2, 2026

Every Action Logged: PaperclipAI's Activity Trail and Cost Tracking

PaperclipAI maintains a complete activity log of every mutation in the system. Agent created, task status changed, approval granted, heartbeat completed — every event is recorded with timestamps. Combined with the cost tracking (provider, model, tokens, cents per heartbeat), you get full operational transparency.

What the activity log captures

  • Agent lifecycle events: creation, state changes (active, paused, error, terminated)
  • Task workflow: status transitions through backlog → todo → in_progress → in_review → done
  • Approval decisions: pending, approved, rejected, revision requested
  • Heartbeat results: execution output, duration, and any errors
  • Cost data: provider, model, input/output tokens, cost in cents per heartbeat
  • Board operator actions: overrides, manual agent management, direct task assignments

Cost reporting endpoints

EndpointWhat It Shows
/api/companies/{id}/costs/summaryTotal company spend this month
/api/companies/{id}/costs/by-agentPer-agent cost breakdown
/api/companies/{id}/costs/by-projectCost attributed to each project/goal

The dashboard surfaces this data visually: current-month spend vs. budget for the company and each agent. Anomalies — like a sudden spike in one agent's costs — become immediately visible.

Want to talk about what AI can do for your business?

30 minutes, no sales pitch. Just an honest conversation about where AI can move the needle for you.

Book a Free Call