Skip to main content
POST
List traces

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request body schema.

startedAfter
string
required

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

workflowUuid
string<uuid>

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

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
chatUuid
string<uuid>

When set, restrict traces to the one holding this AI chat. Every action an agent takes in a chat shares a single trace.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
agentUuid
string<uuid>

When set, restrict traces to those an AI agent started from a chat.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
statuses
enum<string>[]

Filter traces by their derived status (pending if any span anywhere in the trace is still pending, error if a failure stopped the trace, degraded if the trace ran to completion despite a span failing — because the failed node fell back — otherwise success).

Available options:
pending,
error,
degraded,
success
startedBefore
string

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

limit
number

Maximum number of traces to return.

offset
number

Number of traces to skip.

Response

Successful response

traces
Traces · object[]
required

Traces matching the filter.

count
number
required

Total count of matching traces.