info:
  name: Filter by Type - Notes
  type: http
  seq: 4

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

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

  Retrieves all note sync items in the queue.

  **Method:** GET

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

  **Authentication:** Required (Bearer token)

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

  **Response:**
  - `items` (array): Note queue items
    - `id` (string): Queue item UUID
    - `type` (string): `note`
    - `status` (string): Queue status
    - `note_data` (object):
      - `media_id` (string): Associated media
      - `device_id` (string): Source device
      - `note_id` (string): Note identifier
      - `text` (string): Note content
      - `color` (string, optional): Note color (hex)
      - `highlight_id` (string, optional): Parent highlight
      - `position` (object): Location in book
        - `chapter` (string): Chapter reference
        - `page` (integer): Page number
        - `location` (string): Epub location
        - `percentage` (number): Position percentage
      - `created_at` (string): Note 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

  **Note Features:**
  - Rich text content support
  - Color-coded notes
  - Linked to highlights
  - Precise location tracking
  - Cross-device sync
  - Edit history preserved
  - Anonymous notes supported

  **Actions:**
  - `create`: New note from device
  - `update`: Modified note content
  - `delete`: Removed note

  **Use Cases:**
  - Monitor note synchronization
  - Debug note sync failures
  - Track reading activity
  - Analyze annotation patterns
  - Verify content propagation
