Create or update user setting

POST

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

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

OperationId:CreateUserSetting

Saves one setting for the user in the path, naming it in the body. If the user already has a setting with that name, its value is replaced.

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 setting is accepted and applied shortly after. To name the setting in the path instead, use Create or update user setting by name.

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 setting 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 valueBoolean value

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

Response Example

202 - Accepted

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

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

List user settings

Read user setting