Update user setting

PUT

/domains/{domain}/users/{user}/settings/{setting}

Last modified:2026-10-09 00:58:42

OperationId:UpdateUserSetting

Replaces the value of a setting the user in the path already has. A setting the user does not have returns 404; to create one, use Create or update user setting by name (POST on this path) or Create or update user setting.

Office Manager can change the settings of every user in its domain, and Site Manager its own settings and those of users in its site. Basic User, Advanced User, Simple User, Call Center Agent, Call Center Supervisor, Route Manager, and Office Manager Read-Only can change their own settings only. Reseller can change the settings of users in its domains, and Super User the settings of any user. The user in the path decides access: a uid, user, or domain in the query or body has no effect.

A 202 means the change is accepted and applied shortly after. A setting in the body is ignored: the path names the setting.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

The change is accepted and applied shortly after.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

cURL

Object valueString value

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//settings/dashboard.timeWindow' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "value": {
        "start": "08:00",
        "end": "18:00"
    }
}'

Response Example

202 - Accepted

{
    "code": 202,
    "message": "Accepted"
}

Modified at 2026-10-09 00:58:42

Read user setting

Create or update user setting by name