Getting started
Create an API key and run your first document search against Nordvec.
This guide takes you from zero to your first search result.
1. Create an API key
Sign in and create a key from your workspace settings. The raw key is shown once and never again, so store it somewhere safe. Keys are scoped to your workspace and authenticate as a bearer token.
See Authentication for the full lifecycle (rotate, revoke, grace windows).
2. Search your documents
Point any HTTP client at the API base, https://nordvec.com/api/v1, and
send your query. Results come back ranked, each carrying the source document it
came from. query is required; limit (1-50, default 20) is optional.
curl https://nordvec.com/api/v1/documents/search \
-H "Authorization: Bearer $NORDVEC_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "quarterly revenue", "limit": 10 }'Every result references its source document, so you can verify a match rather than just trust it. That is the whole point of the platform.
3. Work with conversations
A conversation is a chat grounded in your documents, where every answer is cited. The API lets you create conversations and list, retrieve, and search them:
# Create a conversation owned by your workspace
curl -X POST https://nordvec.com/api/v1/conversations \
-H "Authorization: Bearer $NORDVEC_API_KEY"