v1

latestOpenAPI 3.1.02026-07-2631411.5 MB

Orchestration - Traces

List traces

List orchestration traces. Each trace wraps every span (node execution) across its run lineage; the summary is aggregated at query time directly from orchestration.spans (no separate traces table — spans carries trace_uuid with a bloom-filter skipping index).

post/orchestration/traces/list

Request body

workflowUuidstring uuid

When set, restrict traces to this workflow. Omit to search across workflows in the workspace.

statusesstring[]

Filter traces by their derived status (pending if any span anywhere in the trace is still pending, error if any of the root run's spans has errored, otherwise success).

startedAfterstring required

Include traces whose first execution started after this timestamp (ISO string). Required.

startedBeforestring

Include traces whose first execution started on or before this timestamp (ISO string).

limitnumber

Maximum number of traces to return.

offsetnumber

Number of traces to skip.

Response

Successful response

countnumber required

Total count of matching traces.