Skip to main content
POST
Review Trace

Authorizations

X-API-Key
string
header
required

Path Parameters

trace_id
string
required

Body

application/json

A review verdict. Include corrected_output when correcting.

action
enum<string>
required

A review verdict.

Available options:
approve,
reject,
correct
expected_version
integer
required

Expected version for optimistic locking. Review fails if version mismatch.

corrected_output
Corrected Output · object | null

Response

Successful Response

A trace with its tags and review history.

id
string
required
created_by
string
required
org_id
string
required
project_id
string
required
status
enum<string>
required

Review status of a trace.

Available options:
pending,
approved,
rejected,
corrected
spans
(MessageSpan · object | ReasoningSpan · object | ToolRequestSpan · object | ToolResponseSpan · object | ErrorSpan · object | UnknownSpan · object)[]
required
model_output
Model Output · object
required
version
integer
required
created_at
string<date-time>
required
corrected_output
Corrected Output · object | null
final_output
Final Output · object | null
trace_config
Trace Config · object | null
output_schema
Output Schema · object | null
deleted_at
string<date-time> | null
deleted_by
string | null
restored_at
string<date-time> | null
restored_by
string | null
tags
TagSummary · object[]
events
TraceEventResponse · object[]