API Reference

The Startrag REST API

A small, predictable surface. Authenticate with a bearer token and start mapping knowledge.

curl https://api.startrag.com/v1/query \
  -H "Authorization: Bearer sk_live_..." \
  -d '{ "q": "What changed in the Q3 policy?" }'

POST/v1/ingest

Add documents to the index. Each chunk becomes a star and is auto-linked into clusters.

POST/v1/query

Run a graph-aware retrieval and return a grounded answer with citations.

GET/v1/constellations

List discovered constellations (semantic clusters) in your knowledge graph.

GET/v1/stars/:id/edges

Traverse the edges of a single star to inspect related context.

DELETE/v1/stars/:id

Remove a star and re-balance its constellation.