Update configuration - NetSapiens API v2

Changes the value of an existing configuration row. The name comes from the path; name the rest of the key in the body, as the list returns it. Each key part you leave out is *, except that below Reseller your own domain and user fill in. A key that matches no row returns 404; to add a row, call POST /configurations. PUT /configurationswithout a name answers405`.

Who can write:

Super User writes any row, including system rows, for any name.

Reseller writes rows for its own territory or a domain in it. With neither reseller nor domain, the row is stored for your territory.

Office Manager and Route Manager write their own domain's rows. domain left out means your domain.

Other scopes with write rights write only their own user's rows in their own domain. user and domain left out mean yours.

Super User Read Only, Route Manager Reseller, Call Center Supervisor, Site Manager, and Office Manager Read-Only are read-only and get 403.

Below Super User, the setting must have a definition whose config-def-allow-reseller-access is yes. A key outside your tier returns 403.

For a secret-named setting, the masked value read back and sent unchanged keeps the stored value. The change is checked, then published over the service bus (SBUS) and applied on every server shortly after, so 202 means accepted, not yet stored. Send domain, reseller, and user in the body: in the query string they're ignored.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

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

🟠405Method Not Allowed

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/configurations/PORTAL_SHOW_SHARED_CONTACTS' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "config-value": "yes", "domain": "example.com" }'