Skip to main content
POST
Retire evaluations

Authorizations

Authorization
string
header
required

API key, not necessarily a JWT. Server derives Organization, permitted actions and Corpus scope; every resource access is authorized.

Body

application/json
key
string
required
Required string length: 1 - 128
plugin_id
string
required
Required string length: 1 - 128
version
string
required
Required string length: 1 - 128
reason
string
required

The operator's explanation for deliberately abandoning these evaluations.

Required string length: 1 - 1024
dry_run
boolean
required
limit
integer
default:100
Required range: 1 <= x <= 500

Response

The dry-run preview or committed audit receipt

key
string
required
plugin_id
string
required
version
string
required
reason
string
required
dry_run
boolean
required
limit
integer
required
Required range: 1 <= x <= 500
retirement_id
string
required
Minimum string length: 1
outcome
enum<string>
required
Available options:
evaluator_retired
items
object[]
required
Maximum array length: 500
remaining
integer
required

Unavailable pending evaluations remaining in this request's scope, including leased ones.

Required range: x >= 0
leased
integer
required

Unavailable pending evaluations skipped because their leases have not expired.

Required range: x >= 0
created_at
string<date-time>