Documents & search

A document is the unit Nordvec searches over: a file, a page, a message, an email, whatever you ingest. Once a document is processed it becomes searchable and can be cited in an answer.

Ingesting documents

Documents enter your workspace two ways:

• Connectors sync from a source you own (the connector owner). New and changed documents are picked up automatically.
• Push sends a document to Nordvec directly from your own system.

Either way, Nordvec processes the document, splits it into passages, and indexes it for retrieval.

Searching

/documents/search is full-text search across your documents' titles and content. It runs standalone, without conversation context, and returns ranked results with text snippets, each carrying the document it came from.

curl https://nordvec.com/api/v1/documents/search \
  -H "Authorization: Bearer $NORDVEC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "renewal terms", "limit": 10 }'

You can also list documents (/documents/list) or fetch one by id (/documents/{id}). See the API reference for the full set of parameters and response shapes.

Try it

Run a query against a small demo corpus. This searches six sample documents in your browser, ranked and sourced, the same shape a real search returns.

Semantic retrieval, which matches passages by meaning rather than exact words, is what powers a conversation's cited answers.

Where documents are cited

Search gives you passages to work with directly. When you want a written answer instead of raw passages, a conversation retrieves over the same documents and cites them in its reply.