Upsert Score
Create or update a Score for a given Record and MetricConfig. If a Score with the specified Record ID and MetricConfig ID already exists, it will be updated. Otherwise, a new Score will be created. The score provided should conform to the schema defined by the MetricConfig; otherwise, validation errors will be reported. Omit score to leave the Score in a pending (ungraded) state, which queues the Record for manual grading; this is supported only for human metrics.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The ID of the Record to upsert the Score for.
"777"
The ID of the MetricConfig.
"a1b2c3d4-e5f6-7890-1234-567890abcdef"
Body
The score of the Record, as arbitrary JSON. This data should ideally conform to the output schema defined by the associated MetricConfig. If it doesn't, validation errors will be captured in the validationErrors field. Omit score to leave the Score in a pending (ungraded) state — supported only for human metrics, e.g. to queue a record for manual grading.
Who created the Score, e.g. a user ID when submitting on behalf of a human grader. Must be a member of your organization. Only supported for human metrics and only together with score; defaults to background-job.
1Response
Score upserted successfully.
A Score represents the evaluation of a Record against a specific MetricConfig. The actual score is stored as flexible JSON. While any JSON is accepted, it is expected to conform to the output schema defined by the MetricConfig. Any discrepancies will be noted in the validationErrors field, but the Score will still be stored.
The ID of the Record this Score is for.
The ID of the MetricConfig this Score is for.
The score of the Record, as arbitrary JSON. This data should ideally conform to the output schema defined by the associated MetricConfig. If it doesn't, validation errors will be captured in the validationErrors field.
Who created the Score: background-job for automated graders, or a user ID for human-entered scores.
Validation errors found in the Score data. If present, the Score doesn't fully conform to its MetricConfig's schema.