Subscriptions

Create subscription

Atomically create enabled Subscription/Version and activation boundary in the durable journal. Evaluate future eligible transitions, not existing history. Replay same key/request returns same identity and does not reactivate a disabled Subscription. The evaluator must be installed (422 unsupported_evaluator); the pinned Saved Query Version expression and the evaluator configuration must satisfy the evaluator's declared schemas (422 invalid_expression with field /saved_query_version_id, or invalid_subscription_configuration with field /evaluator/configuration/...; message names the first schema issue).

Request body

idempotency_keystring required

namestring required

saved_query_idstring required

saved_query_version_idstring required

destination_idstring

ownerstring

Subscription Owner, an opaque end-user reference defined by the client application (for example user-123). Quivr stores, filters and echoes it without interpreting it. At most 128 characters without control characters; none is reserved for the listing filter. A refused owner is 422 invalid_owner, in a creation body as in the listing filter.

Response

Successful response

subscription_idstring required

namestring required

enabledboolean required

deletedboolean required

Logically deleted for good; a deleted Subscription is also disabled and stays readable with its Versions, Matches and Deliveries.

ownerstring

Subscription Owner, an opaque end-user reference defined by the client application (for example user-123). Quivr stores, filters and echoes it without interpreting it. At most 128 characters without control characters; none is reserved for the listing filter. A refused owner is 422 invalid_owner, in a creation body as in the listing filter.

Create subscription

Request

Request body

Response 201Created

Changes

Response