Admin

Retire evaluations

Explicitly abandon a bounded batch of pending evaluations pinned to the named evaluator whose latest error is evaluator_unavailable. Only the key's Organization and granted Corpora are considered. Live leases and withdrawals are left alone. Never migrate an intent, run another evaluator, create a Match or Delivery, or declare no_match. The terminal outcome is evaluator_retired. Each real retirement emits evaluation.retired in the intent's Corpus, with resource.kind=evaluation_retirement and resource.id=retirement_id. The immutable receipt records the reason, original identities and event ids, and is readable at the Location. A real key replay returns the original batch, including its original counts; another request or Corpus scope using that key is 409 idempotency_conflict. An empty real batch also reserves its key. dry_run selects without writes or reserving the key, and remaining reports how many unavailable intents would remain after that selection. Use new real keys for further batches and recheck live backlog counts after dispatch and leases settle. This action does not establish a policy for future intents. It deliberately discards potential alerts; restore the exact old implementation to drain without losing judgments. Requires plugins:admin.

post/v0/admin/subscriptions/evaluation-retirements

Request

  • Base URL
    https://docs.quivr.thevibecompany.co (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Request body

keystring required
plugin_idstring required
versionstring required
reasonstring required

The operator's explanation for deliberately abandoning these evaluations.

dry_runboolean required
limitinteger

Response

The dry-run preview or committed audit receipt

keystring required
plugin_idstring required
versionstring required
reasonstring required
dry_runboolean required
limitinteger required
retirement_idstring required
created_atstring date-time
outcome'evaluator_retired' required
remaininginteger required

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

leasedinteger required

Unavailable pending evaluations skipped because their leases have not expired.

Changes

No recorded changes to this operation across all 1 revision of this API.