info:
  name: Kobo Bookmark Sync
  type: http
  seq: 3
http:
  method: POST
  url: '{{base_url}}/api/v1/kobo/bookmark'
  auth: inherit
  body:
    type: json
    jsonBody: "{\n    \"BookmarkSync\": [\n      {\n        \"BookmarkId\": \"bookmark_2\"\
      ,\n        \"ContentId\": \"kobo_xyz789\",\n        \"BookmarkText\": \"Important\
      \ note\",\n        \"BookmarkType\": \"bookmark\",\n        \"DateCreated\"\
      : \"2026-01-31T12:00:00Z\""
  headers:
  - key: Authorization
    value: Bearer {{device_token

docs: |-
  ## Kobo Bookmark Sync
  
    Synchronizes bookmarks from a Kobo device to the Bookhoard server.
  
    **Method:** POST
  
    **Endpoint:** /api/v1/kobo/bookmark
  
    **Authentication:** Bearer token (device token)
  
    **Request Body:**
    - `BookmarkSync` (array): Array of bookmark objects
      - `BookmarkId` (string): Unique bookmark ID
      - `ContentId` (string): Book/content ID
      - `BookmarkText` (string): Bookmark text or note
      - `BookmarkType` (string): Type (bookmark, highlight, note)
      - `DateCreated` (string): ISO 8601 timestamp
  
    **Response:**
    - `Status` (string): Sync status (Success, Partial)
    - `BookmarksSynced` (number): Number of bookmarks synced
  
    **Status Codes:**
    - 200: Success
    - 401: Unauthorized
    - 500: Internal server error