Replace a score by score ID.
Request
Use the value field matching the evaluator `score_value_type`: `numerical`/`percentage` -> `numerical_value`, `boolean` -> `boolean_value`, `single_select`/`multi_select`/`categorical` -> `categorical_value`, `text`/`comment` -> `string_value`, `json` -> `json_value`.
evaluator_idstringOptional
Evaluator ID. Provide either evaluator_id or evaluator_slug.
evaluator_slugstringOptional
Custom evaluator slug. Provide either evaluator_id or evaluator_slug.
log_idstringOptional
Log/span ID. Required for general score creation when not using the log-scoped route.
timestampdatetimeOptional
Log timestamp. Supplying it can avoid an additional log lookup.
environmentstringOptional
Score environment.
prompt_version_numberintegerOptional
automation_idstringOptional
scorerstringOptional
Optional score producer for general score creation. Log-scoped routes derive this from the authenticated user.
numerical_valuedouble or nullOptional
Numeric score value. Use for numerical and percentage evaluators.
string_valuestring or nullOptional
Text score value. Use for text and legacy comment evaluators.
boolean_valueboolean or nullOptional
Boolean score value. Use for boolean evaluators.
categorical_valuelist of strings or nullOptional
Categorical score values. Use for single_select, multi_select, and legacy categorical evaluators.
json_valuestring or nullOptional
JSON score value encoded as a string. Use for json evaluators.
Response
Updated score.
created_atdatetime
When the score was created.
typeenum
Evaluator execution type. Legacy rows may contain legacy type values.
environmentstring
Environment associated with the score.
numerical_valuedouble or null
Numeric score value. Use for numerical and percentage evaluators.
string_valuestring or null
Text score value. Use for text and legacy comment evaluators.
boolean_valueboolean or null
Boolean score value. Use for boolean evaluators.
categorical_valuelist of strings or null
Categorical score values. Use for single_select, multi_select, and legacy categorical evaluators.
json_valuestring or null
JSON score value encoded as a string. Use for json evaluators.
is_passedboolean or null
Whether the score passes the evaluator conditions.
costdouble or null
Evaluation cost in USD, when available.
evaluator_idstring or null
Evaluator ID associated with the score.
evaluator_slugstring or null
Evaluator slug associated with the score.
evaluator_namestring or null
Human-readable evaluator name, when available.
scorerstring or null
Who or what produced the score. For log-scoped score writes, the backend derives this from the authenticated user.
prompt_idstring or null
Associated prompt ID, when available.
prompt_version_numberinteger or null
Associated prompt version number, when available.
dataset_idstring or null
Associated dataset ID, when available.
automation_idstring or null
Associated automation ID, when available.
statusstring or null
Evaluation status, when available.
error_messagestring or null
Evaluation error message, when available.
inputsobject
Unified evaluator inputs stored with the score, when available.
evaluatorobject or null
Evaluator metadata when the score is associated with a platform evaluator.
