v1

latestOpenAPI 3.1.02026-08-042453938.9 KB
Events

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