Create or update a log score
Create a score for a specific log/span. The backend keeps one score per (log, evaluator, scorer) and updates the existing score if the same combination is submitted again.
Create a score for a specific log/span. The backend keeps one score per (log, evaluator, scorer) and updates the existing score if the same combination is submitted again.
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.
Log/span unique ID to manage scores for.
Evaluator ID. Provide either evaluator_id or evaluator_slug.
Custom evaluator slug. Provide either evaluator_id or evaluator_slug.
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.
Updated existing score for this log/evaluator/scorer.
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. The log ID comes from the path. The backend derives scorer from the authenticated user for this route.