info:
  name: List User Devices
  type: http
  seq: 5

http:
  method: GET
  url: '{{base_url}}/api/devices'
  auth: inherit

docs: |-
  ## List User Devices

  Retrieves all registered devices for the authenticated user.

  **Method:** GET

  **Endpoint:** /api/devices

  **Authentication:** Required (Bearer token)

  **Response:**
  - Array of device objects:
    - `id` (string): Device UUID
    - `device_name` (string): Human-readable device name
    - `device_type` (string): `kobo`, `koreader`, or `web`
    - `device_identifier` (string): Unique device identifier
    - `sync_enabled` (boolean): Whether sync is active
    - `auto_sync` (boolean): Whether automatic sync is enabled
    - `sync_frequency_minutes` (integer): Sync interval in minutes
    - `last_synced_at` (string): Last successful sync timestamp
    - `created_at` (string): Registration timestamp

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

  **Usage:**
  - Display user's devices in account settings
  - Allow users to manage sync settings per device
  - Show last sync time for each device