Skip to main content
POST
Count 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).

Response

Successful response

count
number
required

Number of traces matching the filter.