Skip to main content
POST
Add a human annotation/label to a trace

Authorizations

Authorization
string
header
required

Enter your API key (e.g. dai_sk_test_key_001)

Headers

Authorization
string

Path Parameters

trace_id
string
required

Cookies

decimal_session
string | null

Body

application/json
label
string | null

thumbs_up | thumbs_down | needs_correction (legacy, auto-derived if omitted)

rating
integer | null

1-5 star quality rating

Required range: 1 <= x <= 5
correctness
string | null

correct | partial | incorrect

error_categories
string[] | null

e.g. ["hallucination", "missing_info"]

corrected_output
string | null
tags
string[] | null
notes
string | null
score
number | null
Required range: 0 <= x <= 1
flagged_for_review
boolean | null
default:false
add_to_dataset
boolean | null
default:false

Response

Successful Response