# ClipJot

> Personal bookmark manager with web UI, REST API, browser extension, and mobile apps. Save links from anywhere, access them everywhere.

ClipJot is a self-hosted bookmark manager built with FastHTML and HTMX. It stores bookmarks in SQLite, supports tagging and full-text search, and authenticates via Google or GitHub OAuth. Clients include a web interface, a Chrome extension, and iOS/Android apps.

## Docs

- [API Documentation](https://clipjot.net/docs/api/v1): Interactive API reference for all endpoints
- [API Changelog](https://clipjot.net/docs/api/changelog): History of API changes
- [Full LLM Documentation](https://clipjot.net/llms-full.txt): Expanded documentation with complete API details

## API

- [POST /api/v1/user/profile](https://clipjot.net/api/v1/user/profile): Get current user profile (scope: read)
- [POST /api/v1/auth/invite](https://clipjot.net/api/v1/auth/invite): Authenticate with invite code (public)
- [POST /api/v1/logout](https://clipjot.net/api/v1/logout): Logout and revoke session (scope: read)

- [POST /api/v1/bookmarks/add](https://clipjot.net/api/v1/bookmarks/add): Create a new bookmark (scope: write)
- [POST /api/v1/bookmarks/edit](https://clipjot.net/api/v1/bookmarks/edit): Update an existing bookmark (scope: write)
- [POST /api/v1/bookmarks/delete](https://clipjot.net/api/v1/bookmarks/delete): Delete a bookmark (scope: write)
- [POST /api/v1/bookmarks/search](https://clipjot.net/api/v1/bookmarks/search): Search bookmarks (scope: read)
- [POST /api/v1/bookmarks/list](https://clipjot.net/api/v1/bookmarks/list): List all bookmarks (scope: read)
- [POST /api/v1/bookmarks/sync](https://clipjot.net/api/v1/bookmarks/sync): Incremental sync with long polling (scope: read)

- [POST /api/v1/tags/list](https://clipjot.net/api/v1/tags/list): List all tags (scope: read)
- [POST /api/v1/tags/create](https://clipjot.net/api/v1/tags/create): Create a new tag (scope: write)
- [POST /api/v1/tags/update](https://clipjot.net/api/v1/tags/update): Rename a tag (scope: write)
- [POST /api/v1/tags/delete](https://clipjot.net/api/v1/tags/delete): Delete a tag (scope: write)

- [POST /api/v1/export](https://clipjot.net/api/v1/export): Export all bookmarks (scope: read)
- [POST /api/v1/import](https://clipjot.net/api/v1/import): Import bookmarks (scope: write)

## Optional

- [Privacy Policy](https://clipjot.net/privacy): Privacy policy
- [Health Check](https://clipjot.net/health): Server health endpoint