Skip to main content
POST
Evaluate a test run

Authorizations

Authorization
string
header
required

Access token issued by WorkOS AuthKit.

Headers

Idempotency-Key
string | null

Replaying the same key and payload returns the same evaluation; reusing it with a different payload answers 409.

Required string length: 1 - 255

Body

application/json
test_run_id
string<uuid>
required

Test run whose attributed traffic should be graded.

Example:

"b04bd7fb-3f6c-4de8-9c5a-918909419dcc"

phase
enum<string>
required

Checkpoint grades without closing the run; final closes and grades it.

Available options:
checkpoint,
final
Example:

"final"

evaluator_id
string<uuid> | null

Different ready evaluator used to regrade the latest ready capture for this run and phase.

Example:

"1177bd8d-986f-44a2-aec2-1518dc46d6b0"

Response

Successful Response

id
string<uuid>
required
input_id
string<uuid>
required
evaluator_id
string<uuid>
required
status
enum<string>
required
Available options:
pending,
running,
completed,
error
phase
enum<string>
required
Available options:
checkpoint,
final
coverage_status
enum<string>
required
Available options:
complete,
incomplete,
unknown
verdict
enum<string>
required
Available options:
pending,
passed,
failed,
inconclusive,
error
results
ResultResponse · object[]
required
created_at
string<date-time>
required
regraded_from_id
string<uuid> | null
error_message
string | null