Skip to main content
PUT
/
records
/
{recordId}
/
scores
/
{metricConfigId}
JavaScript
import Scorecard from 'scorecard-ai';

const client = new Scorecard({
  apiKey: 'My API Key',
});

const score = await client.scores.upsert('a1b2c3d4-e5f6-7890-1234-567890abcdef', {
  recordId: '777',
  score: { value: true, reasoning: 'The response is correct' },
});

console.log(score.validationErrors);
{
  "recordId": "777",
  "metricConfigId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "score": {
    "value": true,
    "reasoning": "The response is correct"
  },
  "validationErrors": []
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
recordId
string
required

The ID of the Record to upsert the Score for.

Example:

"777"

​
metricConfigId
string<uuid>
required

The ID of the MetricConfig.

Example:

"a1b2c3d4-e5f6-7890-1234-567890abcdef"

Body

application/json
​
score
object
required

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.

Response

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.

​
recordId
string
required

The ID of the Record this Score is for.

​
metricConfigId
string<uuid>
required

The ID of the MetricConfig this Score is for.

​
score
object
required

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.

​
validationErrors
object[]

Validation errors found in the Score data. If present, the Score doesn't fully conform to its MetricConfig's schema.