Changes an existing configuration definition. Send only the fields to change. code-version cannot be changed and is ignored.Requires Super User scope. Every other scope gets 403.A name with no definition returns 404. The same field checks as a create apply. For a secret-named setting, a masked default value read back and sent unchanged keeps the stored value. Changing default changes the value of every configuration that has no row of its own. Definitions the platform ships are reset to their shipped values on the next upgrade, except that config-def-allow-reseller-access set to yes is kept.The change is published over the service bus (SBUS) and applied on every server shortly after, so 202 means accepted, not yet stored.
Request
Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params
Body Params application/jsonRequired
Examples
Responses
🟢202Accepted
application/json
The change passed every check and was published over the service bus (SBUS); it is applied on every server shortly after: {"code": 202, "message": "Accepted"}. Read the row back to confirm it.
Bodyapplication/json
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
Request Request Example
Shell
JavaScript
Java
Swift
curl--location--request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/config-definitions/PORTAL_SHOW_SHARED_CONTACTS' \
--header'Authorization: Bearer <token>' \
--header'Content-Type: application/json' \
--data'{
"default": "yes",
"description": "Show shared contacts to every user unless a domain turns it off"
}'