API Reference
REST API for articles, tokens, vault sync, and admin.
Base URL: https://api.grovereader.com/api
Authentication
All endpoints require a Bearer token in the Authorization header. Generate tokens at Settings → Tokens.
Authorization: Bearer grv_live_...
Articles
GET
/articles List articles (query: status, limit, tags) GET
/articles/:id Get article with content, highlights, notes POST
/articles/clip Clip a URL to queue PATCH
/articles/:id Update status, tags, notes, vaultPath DELETE
/articles/:id Delete article Tokens
GET
/tokens List your agent tokens POST
/tokens Create a token — body: label DELETE
/tokens/:id Revoke a token Vault
GET
/vault/folders List configured vault folders POST
/vault/folders Add a vault folder Health
GET https://api.grovereader.com/api/health
→ { "status": "ok", "timestamp": "..." }