info:
  name: Update Sync Frequency
  type: http
  seq: 9

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: My Kobo Clara
      sync_enabled: true
      auto_sync: true
      sync_frequency_minutes: 15

docs: |-
  ## Update Sync Frequency

  Changes how often the device automatically syncs with the server.

  **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): Device name
  - `sync_enabled` (boolean): Must be `true` for auto-sync
  - `auto_sync` (boolean): Must be `true`
  - `sync_frequency_minutes` (integer): New sync interval (5-1440)

  **Response:**
  - `id` (string): Device UUID
  - `sync_enabled` (boolean): `true`
  - `auto_sync` (boolean): `true`
  - `sync_frequency_minutes` (integer): Updated interval
  - `next_sync_at` (string): Estimated next sync time
  - `updated_at` (string): Update timestamp

  **Status Codes:**
  - 200: Frequency updated successfully
  - 400: Invalid frequency value
  - 401: Unauthorized
  - 403: Forbidden
  - 404: Device not found

  **Recommended Frequencies:**
  - **Active reading:** 5-10 minutes
  - **Normal usage:** 15-30 minutes
  - **Occasional reading:** 30-60 minutes
  - **Battery saving:** 60+ minutes
  - **WiFi only (3G):** 30-60 minutes

  **Notes:**
  - More frequent sync = more battery usage
  - Sync only occurs when device is online
  - Manual sync can be triggered anytime regardless of frequency
