Conversations & citations

A conversation is a chat grounded in your documents. You ask a question, Nordvec retrieves the relevant passages, and it answers from them, citing the documents it used. If the documents do not support an answer, it says so rather than guessing.

Every answer carries the sources it was built from. This is deliberate: a RAG answer you cannot trace is a liability, not a feature. The citations let a human jump to the exact document a claim came from and confirm it, which is exactly what regulated and high-stakes work needs.

A conversation is owned by the signed-in person who started it, so its endpoints answer to a session, never to an API key. A key is its own principal with no chat history of its own; see Authentication.

With a session you can:

• Create a conversation (POST /conversations).
• List and search your conversations (GET /conversations, GET /conversations/search).
• Retrieve a conversation with its recent messages (GET /conversations/{id}), and page back through older history (GET /conversations/{id}/messages).
• List the documents a conversation has drawn on (GET /conversations/{id}/documents).

See the API reference for the exact request and response shapes.

You can submit feedback on an answer and on the passages that were retrieved. That signal is used to improve retrieval quality over time.