info:
  name: Kobo Markup Sync
  type: http
  seq: 2
http:
  method: POST
  url: '{{base_url}}/api/v1/kobo/markup'
  auth: inherit
  body:
    type: json
    jsonBody: "{\n    \"ReadingSync\": [\n      {\n        \"ContentId\": \"kobo_abc123def456\"\
      ,\n        \"PercentRead\": 60.0,\n        \"RemainingTimeMin\": 120,\n    \
      \    \"ReadingEvent\": \"BookRead\",\n        \"LastModified\": \"2026-01-31T12:00:00Z\""
  headers:
  - key: Authorization
    value: Bearer {{device_token

docs: |-
  ## Kobo Markup Sync
  
    Synchronizes reading progress and markup (highlights, bookmarks) from a Kobo device.
  
    **Method:** POST
  
    **Endpoint:** /api/v1/kobo/markup
  
    **Authentication:** Bearer token (device token)
  
    **Request Body:**
    - `ReadingSync` (array, optional): Reading progress data
      - `ContentId` (string): Book/content ID
      - `PercentRead` (number): Percentage read (0-100)
      - `RemainingTimeMin` (number): Remaining time in minutes
      - `ReadingEvent` (string): Event type (BookRead, etc.)
      - `LastModified` (string): ISO 8601 timestamp
    - `BookmarkSync` (array, optional): Bookmark/highlight data
      - `BookmarkId` (string): Unique bookmark ID
      - `ContentId` (string): Book/content ID
      - `BookmarkText` (string): Highlighted/bookmarked text
      - `BookmarkType` (string): Type (annotation, bookmark)
      - `DateCreated` (string): ISO 8601 timestamp
    - `Metadata` (boolean): Whether to include metadata
  
    **Response:**
    - `Status` (string): Sync status (Success, Partial)
    - `MarkupsSynced` (number): Number of markups synced
    - `BookmarksSynced` (number): Number of bookmarks synced
  
    **Status Codes:**
    - 200: Success
    - 401: Unauthorized
    - 500: Internal server error