info:
  name: Filter by Type - Bookmarks
  type: http
  seq: 6

http:
  method: GET
  url: '{{base_url}}/api/queue/items?status=all&type=bookmark'
  auth: inherit

docs: |-
  ## Filter Queue Items by Bookmarks Type

  Retrieves all bookmark sync items in the queue.

  **Method:** GET

  **Endpoint:** /api/queue/items?status=all&type=bookmark

  **Authentication:** Required (Bearer token)

  **Query Parameters:**
  - `status` (string): Use `all` to get all statuses
  - `type` (string): Must be `bookmark`
  - `media_id` (string, optional): Filter by media item
  - `device_id` (string, optional): Filter by device

  **Response:**
  - `items` (array): Bookmark queue items
    - `id` (string): Queue item UUID
    - `type` (string): `bookmark`
    - `status` (string): Queue status
    - `bookmark_data` (object):
      - `media_id` (string): Associated media
      - `device_id` (string): Source device
      - `bookmark_id` (string): Bookmark identifier
      - `title` (string): Bookmark title (optional)
      - `position` (object):
        - `chapter` (string): Chapter reference
        - `page` (integer): Page number
        - `location` (string): Epub location
        - `percentage` (number): Position percentage
        - `content_path` (string): Internal path (KOReader)
        - `progress` (string): Progress indicator
      - `created_at` (string): Bookmark creation time
      - `modified_at` (string): Last edit time
      - `notes` (string, optional): Bookmark notes
    - `action` (string): `create`, `update`, or `delete`
    - `priority` (integer): Processing priority
    - `created_at` (string): Queued timestamp

  **Status Codes:**
  - 200: Success
  - 401: Unauthorized

  **Bookmark Features:**
  - Custom bookmark titles
  - Chapter-level bookmarks
  - Precise location tracking
  - Progress preservation
  - Cross-device sync
  - Hierarchical organization (KOReader)
  - Kindle location support
  - Kobo chapter marks

  **Device-Specific Features:**
  - **Kobo:** Chapter bookmarks, automatic marks
  - **KOReader:** Hierarchical bookmarks, custom titles, notes
  - **Kindle:** Location-based, page numbers
  - **Web:** Chapter-based, custom titles

  **Bookmark Types:**
  - User-created manual bookmarks
  - Auto-generated chapter marks
  - Last read position
  - Progress milestones (25%, 50%, 75%)
  - Custom collection markers

  **Use Cases:**
  - Monitor bookmark sync
  - Track reading progress points
  - Debug location mapping
  - Verify cross-device bookmarks
  - Export reading positions
