Skip to main content

Delete a score

POST 

/api/v1/evals/delete-score

Deletes a score by ID. The current implementation checks access to the evaluation backend but does not enforce per-author ownership for deletion. Restrict this operation to trusted evaluation administrators until that requirement is implemented.

Obtain the score ID from list scores, read back the deletion result and allow for delayed updates in other views. An immediate response does not establish that every analytics projection is cleared.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Review and score turns

Request​

Responses​

OK

Schema-valid request illustration; replace example identifiers and confirm operation prerequisites.​

Section ID: DOC-IS-evaluation-api-deleteScore#example-evals-deleteScore-request

Request example

{
"scoreId": "example_123"
}

Guide request for Withdraw a rating. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-IS-evaluation-api-deleteScore#example-cookbook-insights-evaluation-review-08-request

Request example

{
"scoreId": "scr_7788"
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-IS-evaluation-api-deleteScore#example-evals-deleteScore-response

Response example

{
"deleted": true
}

Document ID: DOC-IS-evaluation-api-deleteScore. Section identities and revisions.

SectionStable reference
Delete a scoreDOC-IS-evaluation-api-deleteScore#overview
RequestDOC-IS-evaluation-api-deleteScore#request
ResponsesDOC-IS-evaluation-api-deleteScore#responses