Update domain service code

PUT

/domains/{domain}/servicecode/{type}/{code}

Last modified:2026-10-09 01:00:46

OperationId:updateDomainServiceCode

Changes the description of one of a domain's service codes. The path names the code completely, so the body usually carries only srvcode-description.

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.

srvcode-item and srvcode-code in the body are optional. If you send them, they must match the path, or the answer is 400. A domain in the body is ignored: the path decides.

A 202 means the change is accepted and applied shortly after. The API does not check that the code exists first. Returns 404 when the domain does not exist. To change a system-wide code, use PUT /servicecode/{type}/{code} with domain *.

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

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

202 - Accepted

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

Modified at 2026-10-09 01:00:46

Read domain service code

Delete domain service code