Screvi API Docs

Screvi Public APIPublic API for reading and writing your Screvi highlights, sources, articles and tags.Authenticate with a scoped API key: X-API-Key: sk_live_… or Authorization: Bearer sk_live_…. Create one under Settings → API in Screvi.The machine-readable OpenAPI document is at /api/docs.json.Endpoints

GET /api/v1/.well-known/skills/default/skill.md — Get skill.md (standard path)

GET /api/v1/skill.md — Get skill.md (convenience alias)

GET /api/v1/tags — List tags

POST /api/v1/tags — Create a tag

GET /api/v1/highlights — List highlights

POST /api/v1/highlights — Create a highlight

GET /api/v1/highlights/random — Get a random highlight

GET /api/v1/highlights/{id} — Get a highlight

PATCH /api/v1/highlights/{id} — Update a highlight

DELETE /api/v1/highlights/{id} — Delete a highlight

GET /api/v1/search — Hybrid semantic + keyword search highlights

GET /api/v1/sources — List sources

POST /api/v1/sources — Create a source

GET /api/v1/sources/{id} — Get a source

PATCH /api/v1/sources/{id} — Update a source

DELETE /api/v1/sources/{id} — Delete a source

POST /api/v1/highlights/bulk — Create up to 100 highlights in one request

GET /api/v1/articles — List saved articles

POST /api/v1/articles — Save an article by URL

GET /api/v1/articles/{id} — Read an article

PATCH /api/v1/articles/{id} — Update an article

PATCH /api/v1/tags/{id} — Rename or recolor a tag

DELETE /api/v1/tags/{id} — Delete a tag

POST /api/v1/highlights/{id}/tags — Add tags to a highlight

DELETE /api/v1/highlights/{id}/tags — Remove tags from a highlight

POST /api/v1/articles/{id}/tags — Add tags to an article

DELETE /api/v1/articles/{id}/tags — Remove tags from an article