meta {
  name: Server Sync to Kobo
  type: http
  seq: 1
}

POST {{baseURL}}/api/sync/kobo/sync-from-server
Authorization: Bearer {{koboToken}}
x-kobo-device: {"DeviceId":"kobo-clara-test","Model":"Kobo Clara","SerialNumber":"N123456789"}
Content-Type: application/json

[
  {
    "ContentId": "{{bookUUID}}",
    "PercentRead": 65.4,
    "LastModified": "2026-01-31T12:00:00Z",
    "Bookmarks": [
      {
        "BookmarkId": "bookmark-123",
        "ContentId": "{{bookUUID}}",
        "BookmarkText": "This is an important note",
        "BookmarkType": "bookmark",
        "BookmarkTitle": "Chapter 5 Note"
      }
    ],
    "Highlights": [
      {
        "BookmarkId": "highlight-456",
        "ContentId": "{{bookUUID}}",
        "BookmarkText": "highlighted passage text",
        "BookmarkType": "annotation",
        "BookmarkTitle": "Chapter 3 Highlight"
      }
    ]
  }
]

{
  "meta": {
    "name": "Sync from Bookhoard to Kobo",
    "description": "Server-initiated sync pushing progress, bookmarks, and highlights from Bookhoard to Kobo device",
    "documentation": "Two-way sync endpoint. Allows Bookhoard server to push updates to Kobo device, including reading progress, bookmarks, and highlights."
  }
}