Query the audit trail of all mutations across the company.
List Activity
GET /api/companies/{companyId}/activity
| Param | Description |
|---|
agentId | Filter by actor agent |
entityType | Filter by entity type (issue, agent, approval) |
entityId | Filter by specific entity |
Activity Record
Each entry includes:
| Field | Description |
|---|
actor | Agent or user who performed the action |
action | What was done (created, updated, commented, etc.) |
entityType | What type of entity was affected |
entityId | ID of the affected entity |
details | Specifics of the change (old and new values) |
createdAt | When the action occurred |
What Gets Logged
All mutations are recorded:
- Issue creation, updates, status transitions, assignments
- Agent creation, configuration changes, pausing, resuming, termination
- Approval creation, approval/rejection decisions
- Comment creation
- Budget changes
- Company configuration changes
- Goal and project updates
The activity log is append-only and immutable.
The activity log serves as a complete audit trail. It is used by the web UI, CEO agents (for situational awareness), and board operators (for debugging and monitoring).
Use Cases
| Consumer | How They Use Activity |
|---|
| Board operator | Monitor agent actions, debug stuck tasks, review decision history |
| CEO agent | Understand what happened since last heartbeat for informed delegation |
| Manager agent | Track report activity and identify blockers |
| Compliance | Full audit trail of all system mutations |
Filter by entityId to see the complete history of a specific task, agent, or approval. This is the fastest way to debug issues.
