/v0. The endpoint pages of this reference are generated from the OpenAPI contract. From Quivr 2.0.0 on, /v0 is the stable API: 2.x releases only add to it, as Versions and compatibility explains.
Authentication
Send an API key as a bearer token on every request:401 invalid_api_key; an action or Corpus outside the key’s scope is 403 forbidden. A resource of another Organization is 404, never 403: holding an id is not access.
Idempotency
Every request that creates or changes something carries anidempotency_key in its body. Sending the same request again under the same key returns the first result, even after a timeout or a lost response, and never creates a second resource. Sending a different request under a key already used is 409 idempotency_conflict.
Asynchronous writes
Content is accepted before it is processed.POST /v0/records, batches and withdrawals answer 202 Accepted with an Ingestion Receipt once the command is stored durably; its Location header points at the Receipt. Read the Receipt to follow processing. Rebuilds work the same way with an Operation.
Pagination
List endpoints returnitems and, when more remain, a next_page_cursor. Pass it as page_cursor to get the next page, and limit to size pages. A change-feed cursor that expired is 410 cursor_expired, with a resync_url to rebuild your copy from the catalog.
Errors
Every error has the same body:
A mistake gets the same code on every route. A query parameter that is unknown, repeated, or required but missing is
422 invalid_query. A value that a parameter refuses, including an empty one, gets that parameter’s code: invalid_limit for limit, invalid_cursor for page_cursor or cursor, and invalid_owner for a Subscription owner, whether it is in a creation body or in the listing filter. A body that does not match the request schema is invalid_schema. A body that matches but is refused is invalid_input or a more specific code.
A dependency outage is always an error, never an empty success: a search that cannot reach its index fails with 503 rather than returning no results.