Evaluations
Record a human or imported score for a trace
POST /v1/traces/{traceId}/score-results · SDK recordTraceScoreResult · CLI deployments eval score record
POST
Requires observability:write.
platformBearerheader
AuthorizationBearer <token>Platform bearer credential accepted as an opaque API key or JWT.
traceId*stringW3C trace ID (32 lowercase hex characters).
Match
^[a-f0-9]{32}$x-deployments-organization*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$x-deployments-project*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$x-deployments-environment*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$idempotency-key*stringLength
1 <= length <= 512application/json- body
label?stringLength
1 <= length <= 64rationale?stringLength
1 <= length <= 2000runId?stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$scoreDefinitionId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$spanId?stringMatch
^[a-f0-9]{16}$value*numberRange
0 <= value <= 1ScoreResultResponse
application/json- response
agentDeploymentId?stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$agentReleaseId?stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$createdAt*stringMatch
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$Format
date-timedatasetCaseId?stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$durationMs*integerRange
0 <= value <= 9007199254740991errorClass?stringValue in
"evaluator_failed""invalid_configuration""judge_invalid_output""judge_timeout""judge_unavailable""missing_evidence"errorMessage?stringevaluationRunId?stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$evaluatorVersionHash*stringMatch
^[a-f0-9]{64}$evidenceRefs*array<>executionStatus*stringValue in
"error""succeeded"humanActorPrincipalId?stringid*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$judge?label?stringpassed?booleanrationale?stringrevision*integerRange
1 <= value <= 9007199254740991runId?stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$scoreDefinitionId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$scoreType*stringValue in
"deterministic""human""imported""model-judged"source*stringValue in
"api""automatic""evaluation-run"spanId?stringMatch
^[a-f0-9]{16}$threshold*numberRange
0 <= value <= 1traceId*stringMatch
^[a-f0-9]{32}$updatedAt*stringMatch
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$Format
date-timevalue?numberRange
0 <= value <= 1version*integerRange
0 <= value <= 9007199254740991curl -X POST "https://example.com/v1/traces/string/score-results" \ -H "x-deployments-organization: string" \ -H "x-deployments-project: string" \ -H "x-deployments-environment: string" \ -H "idempotency-key: string" \ -H "Content-Type: application/json" \ -d '{ "scoreDefinitionId": "string", "value": 0 }'{ "agentDeploymentId": "string", "agentReleaseId": "string", "createdAt": "2019-08-24T14:15:22Z", "datasetCaseId": "string", "durationMs": 0, "errorClass": "evaluator_failed", "errorMessage": "string", "evaluationRunId": "string", "evaluatorVersionHash": "string", "evidenceRefs": [ { "id": "string", "kind": "message" } ], "executionStatus": "error", "humanActorPrincipalId": "string", "id": "string", "judge": { "costUsdMicros": 0, "inputTokens": 0, "internalEvaluator": true, "modelId": "string", "outputTokens": 0 }, "label": "string", "passed": true, "rationale": "string", "revision": 1, "runId": "string", "scoreDefinitionId": "string", "scoreType": "deterministic", "source": "api", "spanId": "string", "threshold": 0, "traceId": "string", "updatedAt": "2019-08-24T14:15:22Z", "value": 0, "version": 0}