Readeck Integration

Configuration

Configure Readeck access via:

Request parameters: url and apiKey
Environment variables: READECK_URL and READECK_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 key
404: Entry not found
422: Invalid URL or request body