Empty voicemail folder

Developing

DELETE

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

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

OperationId:EmptyVoicemailFolder

Deletes every voicemail message in a folder, with the same result as deleting each message. From new or saved, the messages move to trash. From trash, everything in it is removed for good. Pass permanent=yes to remove new or saved messages for good without moving them to trash.

Only voicemail is removed from new and saved. Faxes kept in the same mailbox stay; delete them under /domains/{domain}/users/{user}/faxes. A message that arrives while the folder is being emptied stays. An empty folder also answers 202, so calling it again is safe.

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 can empty its new and saved folders into trash, but not use permanent=yes or empty trash. The read-only scopes never change voicemail and get 403.

To delete one message, use DELETE on /domains/{domain}/users/{user}/voicemails/{folder}/{filename}. Sending filename, index or ordinal-order to this path returns 400 rather than emptying the 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

Query Params

Responses

🟢202Accepted

application/json

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

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Not Found

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

202 - Success Example

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

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

Play voicemail

Empty voicemail mailbox