readeck

# 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:

```bash
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:

```bash
curl "$READECK_URL/api/bookmarks?limit=20" \
  -H "Authorization: Bearer $READECK_API_KEY"
```

Query parameters: `page`, `limit`, `status`, `search`.

### Get Single Entry

```bash
curl "$READECK_URL/api/bookmarks/$ID" \
  -H "Authorization: Bearer $READECK_API_KEY"
```

### Delete Entry

```bash
curl -X DELETE "$READECK_URL/api/bookmarks/$ID" \
  -H "Authorization: Bearer $READECK_API_KEY"
```

### Mark as Read

```bash
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:**
```json
{"url": "https://example.com", "tags": ["tech", "readlater"]}
```

**Save to specific collection:**
```json
{"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