Empty voicemail mailbox

Developing

DELETE

/domains/{domain}/users/{user}/voicemails

Last modified:2026-10-30 17:30:46

OperationId:EmptyVoicemailMailbox

Removes every voicemail message in the new, saved and trash folders for good, and everything else in trash. This cannot be undone. Faxes in the mailbox, greetings and the name recording stay. An empty mailbox also answers 202.

Every user can empty its own mailbox, and Call Center Supervisor only its own. Site Manager can empty the mailboxes of users at its own site, Office Manager and Route Manager any mailbox in its domain, Reseller and Route Manager Reseller any in their territory, and Super User any. The Owner and Managers of a shared inbox cannot use it. The read-only scopes get 403.

Only DELETE is supported on this path. To list messages, use GET on /domains/{domain}/users/{user}/voicemails/{folder}.

The change is made on the server that handles the request, before the response, and copied to the other servers over the service bus (SBUS) file journal. Message-waiting lights follow on each server's next mailbox scan. Each call is recorded once in the audit log, with the folder, whether it was permanent, and the number of messages. If some messages could not be removed, the call answers 500 after trying all of them, and the message says how many are left.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢202Accepted

application/json

The mailbox is emptied on this server, and the change is being copied to the others.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Not Found

🟠405Method Not Allowed

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//voicemails' \
--header 'Authorization: Bearer <token>'

Response Example

202 - Success Example

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

Modified at 2026-10-30 17:30:46

Empty voicemail folder

List user greetings