Delete a Service Code

DELETE

/servicecode/{type}/{code}

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

OperationId:deleteServiceCode

Deletes the row keyed by {type}/{code} from the path plus domain from the body.

Parameters come from the JSON body, not the query string — a DELETE /servicecode/{type}/{code}?domain=… is a 400 (missing parameter domain). srvcode-description is ignored if sent, so it can never narrow the delete into a no-op.

Because both key segments are in the path, exactly one row is addressed.

Deleting a code that subscribers are still tagged with leaves those subscribers pointing at a code that no longer resolves — check current_service_code_* on GET /domains/{domain} first.

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

Deleted (no body)

This response does not have a body.

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

Delete one domain codeDelete a system-wide codeMissing domain → expect 400

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

Response Example

400 - Write without a domain

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

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

Update a Service Code

Read a Service Code for a Domain