rag

List the organization's documents, newest first. Use when showing the document library, or checking for an existing one before uploading. Changes nothing.

Upload a document into the organization's library and start ingesting it. Use when adding a new document for an agent to ground on.

A filename the library already has is 409 unless replace is true; with it, that document keeps its id (and every agent reading it) and takes the new file, processed again from scratch.

The row is committed before the job is deferred, so a queue that refuses leaves a document in pending with nothing coming for it. That is the reingest route's case, and it is this way round deliberately: the reverse would defer a job for a document that does not exist.

Search one agent's attached documents and return the passages that match. Use when a person, not a running conversation, wants to try what an agent's documents answer for a query — a running conversation retrieves through the built-in instead.

The live version's documents, because this is a person asking. A running conversation asks the pinned version's instead, through the built-in. Propagates agents.NotFound — a 404 — for an agent this organization cannot see, raised by the binding rather than by this slice.

Read one document's details and how far its ingestion has got. Use when checking a specific document's status by id. Changes nothing.

Delete a document and everything indexed from it. Use when a document should stop existing, and every agent attached to it should stop grounding on it — there is no undo.

Download the original file, exactly as it was uploaded. Use when the raw uploaded file itself is needed, not its indexed content. Changes nothing.

Run ingestion again for a document that failed or was never ingested. Use when a document is stuck in a failed or pending state and needs another attempt, without re-uploading the file.