info:
  name: Sync with Annotations
  type: http
  seq: 4
http:
  method: POST
  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/markup'
  auth: inherit
  headers:
  - key: Content-Type
    value: application/json
  - key: x-kobo-device
    value: '{"DeviceId":"{{kobo_device_id}}","Model":"Kobo Libra"}'
  body:
    type: json
    data: "{\n  \"ReadingSync\": [\n    {\n      \"ContentId\": \"book-uuid\",\n      \"PercentRead\": 55.0,\n      \"EntitlementId\": \"entitlement-id\",\n      \"RemainingTimeMinutes\": 120,\n      \"FirstReadTime\": \"2026-01-25T10:00:00Z\",\n      \"LastModified\": \"2026-01-30T20:00:00Z\"\n    }\n  ],\n  \"BookmarkSync\": [\n    {\n      \"ContentId\": \"book-uuid\",\n      \"BookmarkText\": \"Important quote\",\n      \"BookmarkType\": \"annotation\",\n      \"BookmarkTitle\": \"Chapter 4 - The Truth\"\n    },\n    {\n      \"ContentId\": \"book-uuid\",\n      \"BookmarkText\": \"Another quote\",\n      \"BookmarkType\": \"annotation\",\n      \"BookmarkTitle\": \"Chapter 5\"\n    },\n    {\n      \"ContentId\": \"book-uuid\",\n      \"BookmarkText\": \"Note to myself\",\n      \"BookmarkType\": \"note\",\n      \"BookmarkTitle\": \"Personal note\"\n    }\n  ]\n}"
docs: "## Sync with Multiple Annotations\n\nSynchronizes reading progress with multiple highlights and notes.\n\n**Method:** POST\n\n**Endpoint:** /api/sync/kobo/markup\n\n**Authentication:** Bearer token\n\n**Headers:**\n- `Authorization`: Bearer {{kobo_device_token}}\n- `x-kobo-device`: Device info (Model: \"Kobo Libra\")\n\n**Request Body:**\n- `ReadingSync` (array): Single book progress\n- `BookmarkSync` (array): Multiple annotations\n  - Can include highlights (annotation type)\n  - Can include notes (note type)\n  - Each has: ContentId, BookmarkText, BookmarkType, BookmarkTitle\n\n**Response:**\n- `progress_synced` (boolean): Progress update status\n- `annotations_synced` (integer): Number of annotations synced\n- `highlights_count` (integer): Highlights synced\n- `notes_count` (integer): Notes synced\n- `conflicts` (array): Any annotation conflicts resolved\n- `timestamp` (string): Sync completion time\n\n**Status Codes:**\n- 200: Successful sync\n- 401: Unauthorized\n- 400: Invalid\
  \ annotation data\n\n**Kobo Annotation Types:**\n- **Highlights:** Selected text passages\n  - 5 preset colors available\n  - Can have chapter titles\n  - Exportable to PDF/Mobile\n- **Notes:** Personal annotations\n  - Free-form text\n  - Can be attached to highlights\n  - Separate from highlights\n- **Bookmarks:** Location markers\n  - Chapter positions\n  - Quick navigation\n\n**Sync Behavior:**\n- Duplicates detected by content matching\n- Most recent edit wins conflicts\n- Annotations linked to book content\n- Chapter references preserved\n- Order maintained from device\n\n**Kobo Notebook Export:**\n- All annotations appear in Kobo \"Notebook\"\n- Can be exported to PDF\n- Can be exported to Mobile (text)\n- Organized by book\n- Shows highlight context\n\n**Use Cases:**\n- Study and research\n- Book club discussion prep\n- Content review\n- Sharing insights\n- Personal learning archive"