API reference

Base URL: https://api.bookmarks.straccini.com in production, http://localhost:5000 (or whichever port is printed at startup) locally.

All request/response bodies are JSON. All error responses are RFC 7807 application/problem+json.

Resource Reference
Bookmarks /api/bookmarks
Folders /api/folders
Tags /api/tags
Health /health

An interactive, always-up-to-date version of this reference is served by the API itself in development at /swagger.

Authentication

GET requests never require authentication. POST, PUT and DELETE requests require an X-Api-Key header — see Security for details.

1

X-Api-Key: your-secret-key

Missing or invalid keys return 401 Unauthorized.

Table of contents