- name
- readeck
- description
- Readeck integration for saving and managing articles. Supports adding URLs, listing entries, and managing bookmarks via Readeck's API. Configure custom URL and API key per request or via environment variables READECK_URL and READECK_API_KEY.
Readeck Integration
Configuration
Configure Readeck access via:
- Request parameters:
urlandapiKey - Environment variables:
READECK_URLandREADECK_API_KEY
Core Operations
Add Article
Add a URL to Readeck for parsing and saving:
curl -X POST "$READECK_URL/api/bookmarks" \
-H "Authorization: Bearer $READECK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/article"}'Response includes id, url, and title.
List Entries
Fetch saved articles:
curl "$READECK_URL/api/bookmarks?limit=20" \
-H "Authorization: Bearer $READECK_API_KEY"Query parameters: page, limit, status, search.
Get Single Entry
curl "$READECK_URL/api/bookmarks/$ID" \
-H "Authorization: Bearer $READECK_API_KEY"Delete Entry
curl -X DELETE "$READECK_URL/api/bookmarks/$ID" \
-H "Authorization: Bearer $READECK_API_KEY"Mark as Read
curl -X PUT "$READECK_URL/api/bookmarks/$ID/status" \
-H "Authorization: Bearer $READECK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"status": "read"}'Common Patterns
Save with tags:
{"url": "https://example.com", "tags": ["tech", "readlater"]}Save to specific collection:
{"url": "https://example.com", "collection": "my-collection"}Filter by status: unread, read, archived
Error Handling
401: Invalid API key404: Entry not found422: Invalid URL or request body