info:
  name: Filter by Type - Progress
  type: http
  seq: 3

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

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

  Retrieves all reading progress sync items in the queue.

  **Method:** GET

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

  **Authentication:** Required (Bearer token)

  **Query Parameters:**
  - `status` (string): Use `all` to get all statuses
  - `type` (string): Must be `progress`
  - `media_id` (string, optional): Filter by specific media item
  - `device_id` (string, optional): Filter by specific device
  - `limit` (integer, optional): Max items to return

  **Response:**
  - `items` (array): Progress queue items
    - `id` (string): Queue item UUID
    - `type` (string): `progress`
    - `status` (string): `pending`, `processing`, `completed`, `failed`
    - `progress_data` (object):
      - `media_id` (string): Book/media identifier
      - `device_id` (string): Source device
      - `percentage` (integer): Reading progress 0-100
      - `position` (string): Location in book
      - `page_number` (integer, optional): Current page
      - `chapter` (string, optional): Current chapter
      - `finished` (boolean): Book completed flag
      - `timestamp` (string): When progress was recorded
    - `priority` (integer): Processing priority (0-10)
    - `created_at` (string): Queued timestamp

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

  **Progress Sync Features:**
  - Cross-device progress synchronization
  - SHA-256 based book identification (KOReader)
  - Location-based progress (Kobo, Kindle)
  - Page number tracking
  - Chapter bookmarking
  - Finished status propagation
  - Reading time calculation

  **Priority Levels:**
  - 10: Manual sync requests
  - 8: Device-initiated sync
  - 5: Scheduled automatic sync
  - 3: Background updates
  - 1: Bulk operations

  **Use Cases:**
  - Track pending progress updates
  - Monitor sync health across devices
  - Debug progress sync issues
  - Identify devices with stale data
  - Verify progress propagation
