API overview

Quark is a self-hosted RAG document-chat system. All API endpoints are served from your local instance. Base URL: http://localhost:3000/api/v1

All endpoints require a Bearer token in the Authorization header, except GET /api/v1/health. See Authentication for details.

Health check

GET /api/v1/health

Returns the string "up" with no authentication required. Use this to verify your instance is running.

All request and response bodies use JSON. Set the following header on every request:

Content-Type: application/json

Method	Path	Description
`GET`	`/api/v1/health`	Health check — returns `"up"`
`POST`	`/api/v1/ingest/upload/url`	Get a presigned S3 URL for direct file upload
`POST`	`/api/v1/ingest/process`	Ingest and chunk a document into the vector store
`POST`	`/api/v1/chat/completions`	Query documents in a session and receive an answer
`GET`	`/api/v1/chat/history/:sessionId`	Retrieve paginated chat history for a session
`DELETE`	`/api/v1/chat/:sessionId`	Delete all chat messages for a session
`GET`	`/api/v1/session/`	List all sessions for the authenticated user
`POST`	`/api/v1/session/`	Create a new session
`PATCH`	`/api/v1/session/:sessionId`	Rename a session
`DELETE`	`/api/v1/session/:sessionId`	Delete a session

Request a presigned S3 URL to upload a document directly to object storage.

Process an uploaded document into chunks and store embeddings.

Query your documents, retrieve chat history, and delete conversations.

Create, list, rename, and delete chat sessions.