Update user address

PUT

/domains/{domain}/users/{user}/addresses/{emergency-address-id}

Last modified:2026-10-09 00:38:51

OperationId:UpdateAddressForUser

Changes one of a user's emergency (E911) addresses, addressed by its emergency-address-id.

Basic User scope can call it for its own user, with ~ or its own extension. Office Manager and Site Manager scopes can call it for any user in their domain, Reseller scope for the domains in its territory, and Super User scope for any domain.

The address must belong to the user in the path. A shared domain or site address can be changed here only by Office Manager, Site Manager, Reseller, or Super User scope. Any other ID returns 404, and nothing is changed.

address-name is required. Send the other fields you want to change. address-formatted-pidflo is used only together with a supported carrier: bandwidth, brightlink, inteliquent, or voipinno. Without one, the address is saved with an empty address-formatted-pidflo. To change the street, validate the new address first and send its address-formatted-pidflo and carrier.

A 202 means the change is accepted and applied shortly after. Users, devices, sites, and domains assigned this address get the new location.

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

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

RenameNew location from validate (Bandwidth)

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//addresses/a-6525c1ae9d7ff' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "address-name": "Home office (upstairs)"
}'

Response Example

202 - Accepted

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

Modified at 2026-10-09 00:38:51

Delete domain address

Read user address