Admin

Reprocess quarantine

Rerun, with the Pipeline Plan active now, the step a Corpus's stuck Versions failed at, typically after a plugin was fixed and activated or a plan rolled back. A Version quarantined at normalization is normalized again, published with its new Manifest and processed; one quarantined at ingestion is segmented, embedded and indexed again. A Version that succeeds goes through the normal path, as for a first success. It becomes current if its Record still desires it, searchable, its alerts are evaluated, and the change feed announces it (record.materialized when its content changed, record.retrieval_ready, record.enrichment_available). A Version that fails again stays quarantined with its new reason. The scope is the Corpus's stuck Versions (see listQuarantinedVersions), kept by the optional filters, taken when the reprocess is accepted. Set from_stage to normalization to normalize its stored source Blob again before ingestion; omit it to retry the failed step. A dry run is required. dry_run true answers 200 with the count and records it under the idempotency key. The same body with dry_run false then accepts the reprocess as a queued Operation (202, Location). Without a dry run recorded under that key and Corpus, the answer is 409 dry_run_required. The same key with another filter scope or restart stage is 409 idempotency_conflict, and an accepted key replays its Operation. A Corpus whose previous reprocess has not finished is 409 reprocess_in_progress. The reprocess runs on the backfills' task queue at the deployment's backfill.rate, pinned to the plan active when it is accepted. It can be paused, resumed, canceled and rerun. Its counters are versions_in_scope, versions_recovered, versions_quarantined (failed again) and versions_skipped (with skipped_<reason>). Requires plugins:admin, on a key of the Corpus's Organization that grants the Corpus.

post/v0/admin/quarantine/reprocess

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

idempotency_keystring required
corpus_idstring required
pluginstring

Only Versions whose quarantine reason names this plugin id.

codestring

Only Versions quarantined with this reason code.

quarantined_afterstring date-time

Only Versions quarantined at or after this time.

quarantined_beforestring date-time

Only Versions quarantined before this time.

from_stage'normalization'

Restart from the stored source Blob through normalization, then ingestion. Omit to retry the step that failed. Inputs that cannot be republished stay quarantined and are skipped.

dry_runboolean required

true reports the count and records it; false starts the reprocess a dry run with the same key and scope preceded.

Response

The dry run's count, recorded under the key.

versionsinteger required

Stuck Versions in scope.

codesobject required

Of them, how many by reason code.

Changes

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