# Sync Progress

Sync reading progress from KOReader device.

**Endpoint**: `POST /api/sync/koreader/progress`
**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               |
| progress  | array         | Yes      | Array of progress objects |

### Progress Object

| Field       | Type    | Required | Description                        |
| ----------- | ------- | -------- | ---------------------------------- |
| book        | string  | Yes      | Book identifier (filename or UUID) |
| percent     | float   | Yes      | Progress percentage (0-100)        |
| page        | integer | No       | Current page number                |
| total_pages | integer | No       | Total pages in document            |
| date_read   | string  | No       | ISO 8601 timestamp of last read    |
| updated_at  | string  | Yes      | ISO 8601 timestamp                 |

### Example Request

```json
{
  "device_id": "550e8400-e29b-41d4-a716-446655440000",
  "progress": [
    {
      "book": "book.epub",
      "percent": 75.5,
      "page": 150,
      "total_pages": 200,
      "date_read": "2026-02-08T10:00:00Z",
      "updated_at": "2026-02-08T10:00:00Z"
    }
  ]
}
```

## Response (200 OK)

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

## Error Responses

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