info:
  name: Filter by Type - Highlights
  type: http
  seq: 5

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

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

  Retrieves all highlight sync items in the queue.

  **Method:** GET

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

  **Authentication:** Required (Bearer token)

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

  **Response:**
  - `items` (array): Highlight queue items
    - `id` (string): Queue item UUID
    - `type` (string): `highlight`
    - `status` (string): Queue status
    - `highlight_data` (object):
      - `media_id` (string): Associated media
      - `device_id` (string): Source device
      - `highlight_id` (string): Highlight identifier
      - `text` (string): Highlighted text
      - `color` (string): Highlight color (hex or name)
      - `note` (string, optional): Attached note
      - `position` (object):
        - `chapter` (string): Chapter reference
        - `page` (integer): Page number
        - `location` (string): Epub location
        - `percentage` (number): Position percentage
        - `start_position` (string): Selection start
        - `end_position` (string): Selection end
        - `text_offset` (integer): Character offset
      - `created_at` (string): Highlight creation time
      - `modified_at` (string): Last edit time
    - `action` (string): `create`, `update`, or `delete`
    - `priority` (integer): Processing priority
    - `created_at` (string): Queued timestamp

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

  **Highlight Features:**
  - Multi-color support (yellow, green, blue, pink, orange)
  - Precise text selection tracking
  - Linked notes support
  - Chapter and page location
  - Character-level precision
  - Cross-device color preservation
  - KOReader custom colors supported

  **Device-Specific Color Support:**
  - **Kobo:** 5 preset colors (yellow, green, blue, pink, orange)
  - **KOReader:** Custom RGB colors
  - **Kindle:** Yellow, blue, orange
  - **Web:** Full color palette

  **Use Cases:**
  - Track highlight synchronization
  - Debug color mapping issues
  - Monitor annotation activity
  - Analyze reading patterns
  - Export highlights by device
