The Extension API provides REST endpoints for the browser extension to save and manage bookmarks. These are Next.js API routes (not oRPC) and require CORS validation.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ephraimduncan/minimal.so/llms.txt
Use this file to discover all available pages before exploring further.
Authentication
All Extension API endpoints require authentication via session cookie. Requests are authenticated using Next.js session management.CORS
Requests must originate from allowed extension origins. The API validates theOrigin header and returns appropriate CORS headers.
Endpoints
Save Bookmark
POST /api/extension/bookmark
Saves a bookmark from the browser extension. See Import Bookmark.
Import Bookmarks
POST /api/extension/import
Bulk import bookmarks from browser or other sources. See Import Bookmarks.
Check Bookmarks
POST /api/extension/bookmark/check
Check if URLs are already bookmarked. See Check Bookmark.
Error Responses
All endpoints return consistent error responses:Forbidden(403) - Origin not allowed or CORS failureUnauthorized(401) - User not authenticatedBad Request(400) - Invalid request body or parametersServer Error(500) - Internal server error
Rate Limiting
No explicit rate limiting is currently enforced, but bulk operations have size limits:- Import: 2,000 bookmarks per request
- Check: 100 URLs per request
Source Files
- Bookmark save:
app/api/extension/bookmark/route.ts - Import:
app/api/extension/import/route.ts - Check:
app/api/extension/bookmark/check/route.ts - Shared utilities:
app/api/extension/shared.ts