Update service code

PUT

/servicecode/{type}/{code}

Last modified:2026-10-06 16:23:49

OperationId:updateServiceCode

Changes the description of one service code. The path names the type and code, and domain in the body names the domain. Send domain as * to change a system-wide code. domain is required: a write without it returns 400. Send "domain": "*" to address a system-wide code, which needs Super User scope.

Requires Office Manager scope or above for your own domain, Reseller scope for the domains in your territory, or Super User scope for any domain. System-wide codes, with domain *, are shared by every domain. Only Super User scope can create, change, or delete them. Any other scope gets 403.

srvcode-item and srvcode-code in the body are optional. If you send them, they must match the path, or the answer is 400. domain is read from the body, never from the query string.

A 202 means the change is accepted and applied shortly after. The API does not check that the code exists first. To change a domain's own code, PUT /domains/{domain}/servicecode/{type}/{code} puts the domain in the path.

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 this response.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

Change a domain codeChange a system-wide code (Super User)

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

Response Example

202 - Accepted

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

Modified at 2026-10-06 16:23:49

Read service code

Delete service code