Subscription previews

Preview subscription

Dry run of a proposed Subscription. Runs the evaluator on the most recently accepted current eligible Record Versions of the Saved Query's Corpora, newest first, and returns what it would have matched. Nothing is written - no Saved Query, Subscription, Match, Delivery or event - and it is not idempotent. The Saved Query is an inline definition or an existing Saved Query Version; the pair is validated as at Subscription creation (422 unsupported_evaluator, invalid_expression, invalid_subscription_configuration). Each Record Version costs one evaluator call, sent with the synthetic Subscription reference preview. At most limit Record Versions (1 to 50, default 20) are judged, within a four-second budget including preparation and storage reads; those still undecided when it runs out are left out and complete is false. An evaluator that cannot be reached or reports a transient failure fails the preview with 503 evaluator_unavailable, and one that refuses or breaks an evaluation with 502 evaluator_error. A deadline during preparation or an earlier caller deadline returns retryable 504 preview_deadline_exceeded. A storage failure remains 503 storage_unavailable. Quivr applies no rate or cost rule; a layer above can limit who previews and how often.

post/v0/subscription-previews

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

saved_query_idstring
saved_query_version_idstring
limitinteger

The most Record Versions to judge, newest first. Each one costs an evaluator call.

accepted_afterstring date-time

Judge only revisions accepted after this instant.

Response

Successful response

evaluatedinteger required

Record Versions the evaluator decided.

matchedinteger required
not_readyinteger required

Record Versions the evaluator could not decide yet (for example before enrichment).

completeboolean required

False when the time budget ran out before every listed Record Version was decided.

oldest_accepted_atstring date-time

When the oldest decided Record Version was accepted; absent when none was decided.

Changes

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