v1
latestOpenAPI 3.1.02026-08-042453938.9 KBEvents
Trace event causality
Get the full causality context for an event in a single API call.
Returns:
- ancestors: Parent chain from root to this event's parent
- children: Direct child events caused by this event
- retryChain: Original event and all retry attempts
- anomalies: Detected anomalies linked to this event
- summary: Quick stats (counts, hasFailures flag)
Query Parameters:
- format=tree - Returns ASCII tree output for CLI/support tickets
This is the primary debugging endpoint for tracing errors through the ledger.
Example use case: Customer reports "my run failed at step 5"
GET /v1/events/{failingEventId}/trace
GET /v1/events/{failingEventId}/trace?format=tree
Returns the complete context: what led to this event, what it triggered, whether it was retried, and any anomalies detected.
get/v1/events/{id}/trace
Path parameters
idstring required
Event ID to trace
Query parameters
format'json' | 'tree'
Output format (default: json)
Response
Full event trace with causality context