Delete service code

DELETE

/servicecode/{type}/{code}

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

OperationId:deleteServiceCode

Deletes one service code. The path names the type and code, and domain in the body names the domain. Send domain as * to delete 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.

domain is read from the body, never from the query string. srvcode-description is ignored if you send it.

A 202 means the delete is accepted and applied shortly after. Deleting a code that does not exist is accepted too. Users whose service-code names the deleted code keep that value: GET /domains/{domain}/billing reports how many users carry each code. To delete a domain's own code, DELETE /domains/{domain}/servicecode/{type}/{code} needs no body.

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 delete is accepted and applied shortly after this response.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

Delete a domain codeDelete a system-wide code (Super User)

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/servicecode/%2A/hotdesk' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "domain": "example.com"
}'

Response Example

202 - Accepted

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

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

Update service code

Read domain service code