# Sync Bookmarks

Sync bookmarks from KOReader device.

**Endpoint**: `POST /api/sync/koreader/bookmarks`
**Auth**: Required (Device authentication)

## Device Authentication

This endpoint requires device authentication (not user JWT). Devices authenticate using their device credentials.

## Request Body

| Field | Type | Required | Description |
|--------|------|-----------|-------------|
| device_id | string (UUID) | Yes | Device UUID |
| bookmarks | array | Yes | Array of bookmark objects |

### Bookmark Object

| Field | Type | Required | Description |
|--------|------|-----------|-------------|
| book | string | Yes | Book identifier |
| chapter | string | No | Chapter title |
| page | integer | No | Page number |
| position | float | Yes | Position in document (0-1) |
| notes | string | No | Bookmark notes |
| highlighted_text | string | No | Highlighted text |
| time | string | Yes | ISO 8601 timestamp |
| created_at | string | Yes | ISO 8601 timestamp |

### Example Request

```json
{
  "device_id": "550e8400-e29b-41d4-a716-446655440000",
  "bookmarks": [
    {
      "book": "book.epub",
      "chapter": "Chapter 1",
      "page": 25,
      "position": 0.125,
      "notes": "Important section",
      "highlighted_text": "Text to remember",
      "time": "2026-02-08T10:00:00Z",
      "created_at": "2026-02-08T10:00:00Z"
    }
  ]
}
```

## Response (200 OK)

```json
{
  "message": "Bookmarks synced successfully",
  "synced_count": 1
}
```

## Error Responses

| Code | Description |
|------|-------------|
| 401 | Device authentication failed |
| 400 | Invalid request data |
| 404 | Device not found |
