Update territory

PUT

/resellers/{reseller}

Last modified:2026-10-08 23:03:46

OperationId:UpdateReseller

Changes a territory's description or SMTP settings. Fields you leave out keep their values. The path is the key, so the name cannot be changed: a reseller in the body is ignored.

Super User can update any territory, and a Reseller only its own. A Reseller naming another territory gets 403, and so do Super User Read Only and every other scope.

Reads mask email-send-smtp-password. Sending that mask back unchanged keeps the stored password, so you can return a read's body as it is. Any other masked-looking password returns 400.

A 202 means the change was published over the service bus (SBUS), not yet applied. Each core server applies it when the event arrives. A territory that does not exist returns 404. PUT /resellers without a name returns 405.

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/json

Examples

Responses

🟢202Accepted

text/html

The change was published over the service bus and will be applied on each core server.

🟠400Bad Request

🟠401Authentication Required

🟠404Record not found

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

Example 1Change descriptionChange SMTP serverRound-trip a read

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/resellers/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "territory": "MyReseller",
    "description": "Acme UCaaS Services Unlimited!"
}'

Response Example

202 - Change description

Published.

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

Modified at 2026-10-08 23:03:46

Count territories

Delete territory