info:
  name: Update Device Settings
  type: http
  seq: 7

http:
  method: PUT
  url: '{{base_url}}/api/devices/{{device_id}}'
  auth: inherit
  headers:
    - key: Content-Type
      value: application/json
  body:
    type: json
    json:
      device_name: Updated Device Name
      sync_enabled: true
      auto_sync: true
      sync_frequency_minutes: 10

docs: |-
  ## Update Device Settings

  Updates device configuration and sync settings.

  **Method:** PUT

  **Endpoint:** /api/devices/:device_id

  **Authentication:** Required (Bearer token)

  **Path Parameters:**
  - `device_id` (string): UUID of the device

  **Request Body:**
  - `device_name` (string, optional): New device name
  - `sync_enabled` (boolean, optional): Enable/disable sync
  - `auto_sync` (boolean, optional): Enable automatic sync
  - `sync_frequency_minutes` (integer, optional): Sync interval (5-1440 minutes)

  **Response:**
  - `id` (string): Device UUID
  - `device_name` (string): Updated device name
  - `sync_enabled` (boolean): Updated sync status
  - `auto_sync` (boolean): Updated auto-sync setting
  - `sync_frequency_minutes` (integer): Updated sync interval
  - `updated_at` (string): Update timestamp

  **Status Codes:**
  - 200: Settings updated successfully
  - 400: Invalid sync frequency or data
  - 401: Unauthorized
  - 403: Forbidden (device belongs to different user)
  - 404: Device not found

  **Sync Frequency Guidelines:**
  - Mobile devices: 10-30 minutes
  - E-readers on WiFi: 15-60 minutes
  - Web clients: 5-15 minutes
  - Minimum: 5 minutes
  - Maximum: 1440 minutes (24 hours)