Api reference
API Reference
Complete reference for all bookmark.land API endpoints
Base URL
https://api.bookmark.land/v1Authentication
All requests require a Bearer token:
curl -H "Authorization: Bearer bkl_your_token_here" \
https://api.bookmark.land/v1/bookmarksSee Authentication for details.
Request Format
- GET requests use query parameters
- POST/PATCH/PUT/DELETE requests use JSON body with
Content-Type: application/json - Maximum payload size: 1 MB (5 MB for import endpoints)
Response Envelope
Every response uses a consistent envelope:
{
"data": { ... },
"meta": { "requestId": "req_a1b2c3d4e5f6a1b2" }
}Error responses:
{
"error": {
"code": "ERROR_CODE",
"message": "Human-readable description"
},
"meta": { "requestId": "req_a1b2c3d4e5f6a1b2" }
}CORS
The API supports CORS with the following headers:
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE, OPTIONS
Access-Control-Allow-Headers: Authorization, Content-Type, Idempotency-KeyVerify Token
POST /auth/verifyReturns information about the authenticated user.
Scope: any valid token
Response:
{
"data": {
"userId": "user_abc123",
"name": "Jane Doe",
"email": "[email protected]",
"plan": "pro",
"status": "active"
}
}