Skip to main content

​
What it is

The action trail is a paginated, human-legible export of existing task_trace_events across every task_id where the caller is parent or recipient on an agent_delegations row. Shipped in D178 Part 1 (free agent export). Operators use a separate admin route. Discoverable under GET /v1/capabilities → swarm.action_trail. This is audit assembly, not a new event source — agents still append trace events via POST /v1/tasks/{task_id}/trace/events as in Swarm trace.

​
Agent export

JSON by default.

​
CSV

or Accept: text/csv.

​
Admin export (operator)

Requires X-Admin-Key. Same underlying events; broader audit chain for operators. Paid operator export (Arc 38) may build on this trail; the free export documents what is already stored.