Prerequisites
- A running Quivr and, in your shell,
QUIVR_API_URLand aQUIVR_API_KEYwithcorpora:write,content:write,content:read,blobs:writeandsearch:query. With the local stack,eval "$(make -s env)"sets them (Quickstart). - A Corpus to write to:
Send an article with a title
Plain text becomes onebody Part. To give an article a title, which search weighs more than the body, send a Manifest with a title Part and a body Part:
namespace) and its Record Key. source_revision is optional: the source’s own version label. When you send it, Quivr uses it to tell corrections from duplicates; without it, the content itself decides.
Read the Receipt to know when the article is searchable:
Correct an article
Send new content for the same Record Key. It becomes a new Version of the same Record:source_position, a number that grows with each revision at the source, such as a sequence number or a timestamp in digits. An older position never replaces a newer Version.
Send many articles at once
POST /v0/records/batch takes up to 100 commands, 10 MiB in total and 1 MiB each. Each entry gets its own Receipt or its own error, in order, so one invalid entry does not block the others:
Upload a file
Files go through an upload session. You declare the size, SHA-256 and media type, send the bytes to the URL Quivr returns, and confirm; Quivr reads the bytes back and checks them before they become a Blob. The same request again returns the same session, so the bytes are sent only while it isawaiting_upload.
text/* files itself. Other media types need a normalizer plugin routed for them: the local stack routes application/pdf to the first-party pdf-text plugin, which makes one Part per page. Upload a PDF the same way with "media_type": "application/pdf". A media type with no route is refused with 422 unverified_blob. An upload URL expires after 15 minutes, and a file is at most 1 GiB.
Withdraw an article
A withdrawal removes a Record from search and alerts at once, and permanently: a later submission for the same Record Key is aconflict. Its history stays readable.
Limits
A Version over the indexing limits, or with no title or body text, is stored and readable, but not searchable: its Receipt shows
ingestion_refused, and the Version’s diagnostic says which limit, or that it has no text to index.
If you can’t find it
First check that the search covers the right collection and that your API key can read it. Then read the article’s Receipt: itsprocessing progress, its availability readiness and its diagnostics, which explain failures.
Sending a quarantined article again with the same key returns its Receipt; it does not restart processing.
Next
Search
Find what you added, by keyword or by meaning.
Collect from a source
Let Quivr pull articles from feeds and mailboxes on a schedule.