info:
  name: Sync from Bookhoard to Kobo
  type: http
  seq: 1
http:
  method: POST
  url: '{{baseURL}}/api/sync/kobo/sync-from-server'
  auth: inherit
  body:
    type: json
    jsonBody: "[\n    {\n      \"ContentId\": \"{{bookUUID"
  headers:
  - key: Authorization
    value: Bearer {{koboToken

docs: |-
  ## Sync from Bookhoard to Kobo
  
    Server-initiated sync pushing progress, bookmarks, and highlights from Bookhoard to Kobo device. Two-way sync endpoint.
  
    **Method:** POST
  
    **Endpoint:** /api/sync/kobo/sync-from-server
  
    **Authentication:** Bearer token with Kobo device identification
  
    **Headers:**
    - `x-kobo-device` (string): JSON string containing Kobo device info
      - `DeviceId`: Kobo device ID
      - `Model`: Kobo device model
      - `SerialNumber`: Kobo device serial number
  
    **Request Body:** Array of sync data objects
    - `ContentId` (string): Book UUID
    - `PercentRead` (number): Reading progress percentage (0-100)
    - `LastModified` (string): ISO 8601 timestamp
    - `Bookmarks` (array, optional): Array of bookmark objects
      - `BookmarkId`: Unique bookmark ID
      - `ContentId`: Book UUID
      - `BookmarkText`: Bookmark text/note
      - `BookmarkType`: Type (bookmark, annotation, etc.)
      - `BookmarkTitle`: Bookmark title
    - `Highlights` (array, optional): Array of highlight objects (same structure as bookmarks)
  
    **Response:**
    - Sync result confirmation
  
    **Status Codes:**
    - 200: Success
    - 401: Unauthorized
    - 500: Internal server error
  
    **Note:** Allows Bookhoard server to push updates to Kobo device, including reading progress, bookmarks, and highlights.
