lumen.trace.detail

Fetch trace context, timeline, and related error groups for a public trace UUID.

Fetch one tenant-scoped trace timeline by public trace UUID.

Overview

Property	Value
Workflow type	Atomic
Library	App-lumen
Version	1.0

Input Schema

Field	Type	Required	Default	Description
organization_uuid	uuid	Yes	—	Organization UUID to scope the read-only query.
trace_ref	string	Yes	—	Public trace UUID string.
include_log_context	boolean	No	—	Include sanitized log context in timeline logs; default false.
include_log_traceback	boolean	No	—	Include traceback text in timeline logs; default false.

Output Schema

Field	Type	Required	Default	Description
trace	json	No	—	Trace metadata or null.
timeline	list	Yes	—	Ordered spans and orphan logs.
error_groups	list	Yes	—	Related error groups.
error	string	No	—	—
error_type	string	No	—	—

States

State	Initial	Terminal	Success	Auto-advance	Description
done	Yes	Yes	Yes	—	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "lumen.trace.detail",
  "initial_data": {
    "organization_uuid": "value",
    "trace_ref": "value"
  }
}