Update a Service Code

PUT

/servicecode/{type}/{code}

Last modified:2026-07-28 22:51:25

OperationId:updateServiceCode

Updates the row keyed by {type}/{code} from the path plus domain from the body. In practice srvcode-description is the only editable field.

Parameters come from the JSON body — query-string values are ignored on PUT. If the body includes srvcode-item or srvcode-code they must match their path segments, or the request is a 400.

This is an upsert: if no row matches the triple, one is created.

Example: PUT /servicecode/subscriber/system-hotdesk

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

🟢200OK

Updated (no body)

This response does not have a body.

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

Edit the descriptionEdit a system-wide codeMissing domain → expect 400Body srvcode-code disagrees with the path → expect 400Body srvcode-item disagrees with the path → expect 400

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/servicecode//' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "domain": "example.com",
    "srvcode-description": "Hot-desk user (shared phone)"
}'

Response Example

400 - Write without a domain

{
    "code": 400,
    "message": "Bad request. Missing parameter 'domain'."
}

Modified at 2026-07-28 22:51:25

Read a Service Code

Delete a Service Code