---
title: "Save user folder preferences values."
method: POST
path: "/user-folder-preferences/{folderId}"
tags: ["Use Folder Preferences"]
---

# Save user folder preferences values.

`POST /user-folder-preferences/{folderId}`

Persists given preferences values.

## Path parameters

- `folderId` integer, required

## Request body

- union — The preferences object to save.
  - XiqClientDensityThresholds — Client density threshold preferences object
    - `type` string — The type of values
    - `data` XiqClientDensityThresholdsInfo, required — Client density threshold preferences
      - `excellent` integer, required — Low client density
      - `good` integer, required — Medium-low client density
      - `medium` integer, required — Medium client density
      - `poor` integer, required — High client density
  - XiqCoChannelInterferenceThresholds — Co channel interference threshold preferences object
    - `type` string — The type of values
    - `data` XiqCoChannelInterferenceThresholdsInfo, required — Co channel threshold values
      - `excellent` integer, required — excellent co channel interference threshold
      - `good` integer, required — good co channel interference threshold
      - `medium` integer, required — medium co channel interference threshold
      - `poor` integer, required — poor co channel interference threshold
  - XiqCoverageOverlapThresholds — Coverage overlap threshold preferences object
    - `type` string — The type of values
    - `data` XiqCoverageOverlapThresholdsInfo, required — Coverage overlap threshold preferences
      - `excellent` integer, required — excellent coverage overlap threshold
      - `good` integer, required — good coverage overlap threshold
      - `medium` integer, required — medium coverage overlap threshold
      - `poor` integer, required — poor coverage overlap threshold
  - XiqLayerOpacityPreferences — Layer opacity preferences
    - `type` string — The type of values
    - `data` XiqLayerOpacityInfo, required — Layer opacity data
      - `walls` integer, required — Walls layer opacity
      - `devices` integer, required — Devices layer opacity
      - `grid` integer, required — Grid layer opacity
      - `heatmap` integer, required — Heatmap layer opacity
      - `background` integer, required — Background layer opacity
      - `clients` integer, required — Clients layer opacity
      - `zones` integer, required — Zones layer opacity
      - `labels` integer, required — Labels layer opacity
  - XiqRssiThresholds — RSSI threshold preferences object
    - `type` string — The type of values
    - `data` XiqRssiThresholdsInfo, required — RSSI threshold preferences
      - `excellent` integer, required — excellent rssi threshold
      - `good` integer, required — good rssi threshold
      - `medium` integer, required — medium rssi threshold
      - `poor` integer, required — poor rssi threshold
  - XiqSnrThresholds — RSSI threshold preferences object
    - `type` string — The type of values
    - `data` XiqSnrThresholdsInfo, required — SNR threshold values
      - `excellent` integer, required — excellent snr threshold
      - `good` integer, required — good snr threshold
      - `medium` integer, required — medium snr threshold
      - `poor` integer, required — poor snr threshold

## Response `200`

OK

- union
  - XiqClientDensityThresholds — Client density threshold preferences object
    - `type` string — The type of values
    - `data` XiqClientDensityThresholdsInfo, required — Client density threshold preferences
      - `excellent` integer, required — Low client density
      - `good` integer, required — Medium-low client density
      - `medium` integer, required — Medium client density
      - `poor` integer, required — High client density
  - XiqCoChannelInterferenceThresholds — Co channel interference threshold preferences object
    - `type` string — The type of values
    - `data` XiqCoChannelInterferenceThresholdsInfo, required — Co channel threshold values
      - `excellent` integer, required — excellent co channel interference threshold
      - `good` integer, required — good co channel interference threshold
      - `medium` integer, required — medium co channel interference threshold
      - `poor` integer, required — poor co channel interference threshold
  - XiqCoverageOverlapThresholds — Coverage overlap threshold preferences object
    - `type` string — The type of values
    - `data` XiqCoverageOverlapThresholdsInfo, required — Coverage overlap threshold preferences
      - `excellent` integer, required — excellent coverage overlap threshold
      - `good` integer, required — good coverage overlap threshold
      - `medium` integer, required — medium coverage overlap threshold
      - `poor` integer, required — poor coverage overlap threshold
  - XiqLayerOpacityPreferences — Layer opacity preferences
    - `type` string — The type of values
    - `data` XiqLayerOpacityInfo, required — Layer opacity data
      - `walls` integer, required — Walls layer opacity
      - `devices` integer, required — Devices layer opacity
      - `grid` integer, required — Grid layer opacity
      - `heatmap` integer, required — Heatmap layer opacity
      - `background` integer, required — Background layer opacity
      - `clients` integer, required — Clients layer opacity
      - `zones` integer, required — Zones layer opacity
      - `labels` integer, required — Labels layer opacity
  - XiqRssiThresholds — RSSI threshold preferences object
    - `type` string — The type of values
    - `data` XiqRssiThresholdsInfo, required — RSSI threshold preferences
      - `excellent` integer, required — excellent rssi threshold
      - `good` integer, required — good rssi threshold
      - `medium` integer, required — medium rssi threshold
      - `poor` integer, required — poor rssi threshold
  - XiqSnrThresholds — RSSI threshold preferences object
    - `type` string — The type of values
    - `data` XiqSnrThresholdsInfo, required — SNR threshold values
      - `excellent` integer, required — excellent snr threshold
      - `good` integer, required — good snr threshold
      - `medium` integer, required — medium snr threshold
      - `poor` integer, required — poor snr threshold

## Changes

> 6 revisions in range; 1 not diffed.

- **2026-08-18** `242a0e1b1b40` — 12 breaking
  - the `oneOf[#/components/schemas/XiqClientDensityThresholds]/` request property type/format changed from `object`/`` to ``/``
  - the `oneOf[#/components/schemas/XiqCoChannelInterferenceThresholds]/` request property type/format changed from `object`/`` to ``/``
  - the `oneOf[#/components/schemas/XiqCoverageOverlapThresholds]/` request property type/format changed from `object`/`` to ``/``
  - the `oneOf[#/components/schemas/XiqLayerOpacityPreferences]/` request property type/format changed from `object`/`` to ``/``
  - …8 more

[Change history](https://skmtc.dev/extremecloudiq/apis/extremecloud-iq-api/changes/user-folder-preferences/:folderId/post.md)

---

[API](https://skmtc.dev/extremecloudiq/apis/extremecloud-iq-api.md) · [All operations](https://skmtc.dev/extremecloudiq/apis/extremecloud-iq-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/extremecloudiq/extremecloud-iq-api/revisions/5cefd06a809b/schema)