Replace a score
Replace a score by score ID.
Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.
Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.
Score ID returned as id in score responses.
Evaluator ID. Provide either evaluator_id or evaluator_slug.
Custom evaluator slug. Provide either evaluator_id or evaluator_slug.
Log/span ID. Required for general score creation when not using the log-scoped route.
Optional score producer for general score creation. Log-scoped routes derive this from the authenticated user.
Numeric score value. Use for numerical and percentage evaluators.
Text score value. Use for text and legacy comment evaluators.
Boolean score value. Use for boolean evaluators.
Categorical score values. Use for single_select, multi_select, and legacy categorical evaluators.
JSON score value encoded as a string. Use for json evaluators.
Numeric score value. Use for numerical and percentage evaluators.
Text score value. Use for text and legacy comment evaluators.
Boolean score value. Use for boolean evaluators.
Categorical score values. Use for single_select, multi_select, and legacy categorical evaluators.
JSON score value encoded as a string. Use for json evaluators.
Human-readable evaluator name, when available.
Who or what produced the score. For log-scoped score writes, the backend derives this from the authenticated user.
Associated log/span ID.
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.