PATCH
/
v1
/
run
/
{run_id}
/
testrecord
/
{testrecord_id}
/
score
/
{score_id}
curl --request PATCH \
  --url https://api.getscorecard.ai/v1/run/{run_id}/testrecord/{testrecord_id}/score/{score_id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "int_score": 1,
  "binary_score": false,
  "reasoning": "Turns out the moon insn'\''t acutally made of cheese."
}'
{
  "user_id": "<string>",
  "id": 1,
  "run_id": 1,
  "testcase_id": 1,
  "testrecord_id": 1,
  "metric_id": 1,
  "binary_score": true,
  "int_score": 1,
  "reasoning": "The moon is not made of cheese so this result is not factual.",
  "human_eval": true,
  "status": "pending",
  "error_message": "An error occurred while creating the grade.",
  "created_at": "2025-02-06T23:05:50.132525",
  "updated_at": "2025-02-07T00:04:50.132584"
}

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
run_id
integer
required

The run ID that created the test record to be scored.

Example:

1

​
testrecord_id
integer
required

The ID of the testrecord whose score will be updated.

Example:

12

​
score_id
integer
required

The ID of the score to be updated.

Example:

123

Body

application/json
​
int_score
integer | null
required

The new integer score to assign.

Example:

1

​
binary_score
boolean | null
required

The new boolean score to assign.

Example:

false

​
reasoning
string | null
required

The reasoning for the score update.

Example:

"Turns out the moon insn't acutally made of cheese."

Response

200
application/json
Successful Response
​
user_id
string | null
​
id
integer | null

The ID of the grade.

Example:

1

​
run_id
integer | null

The ID of the run that created the grade.

Example:

1

​
testcase_id
integer | null

The ID of the testcase associated with the grade.

Example:

1

​
testrecord_id
integer | null

The ID of the testrecord for which the grade was created.

Example:

1

​
metric_id
integer | null

The ID of the metric used to compute the grade.

Example:

1

​
binary_score
boolean | null

The binary score assigned to the grade.

Example:

true

​
int_score
integer | null

The integer score assigned to the grade.

Example:

1

​
reasoning
string | null

The reasoning for the assigned score.

Example:

"The moon is not made of cheese so this result is not factual."

​
human_eval
boolean
default:true

Indicates if a human should assign a grade.

Example:

true

​
status
enum<string>
default:pending

The status of the grade.

Available options:
pending,
error,
completed
Example:

"pending"

​
error_message
string | null

The error message if the grade was not created successfully.

Example:

"An error occurred while creating the grade."

​
created_at
string | null

when the grade was created.

Example:

"2025-02-06T23:05:50.132525"

​
updated_at
string | null

when the grade was last updated.

Example:

"2025-02-07T00:04:50.132584"

Was this page helpful?