Delete user avatar by filename

DELETE

/domains/{domain}/users/{user}/avatar/{filename}

Last modified:2026-10-09 00:52:04

OperationId:DeleteUserAvatarFile

Deletes one of the user's stored avatars, addressed by its filename. When it is the user's current avatar, the user is left with none.

Basic User, Advanced User, Simple User, and Call Center Agent can change their own avatar only. Site Manager can change its own and those of users at its own site. Office Manager and Call Center Supervisor can change those of any user in their domain, Reseller those of users in domains of its territory, and Super User any user's. Office Manager Read-Only, Super User Read Only, and any other user get 403.

The avatar must belong to the user the path names, or the call returns 404. 202 means the delete was published over the service bus (SBUS), not yet applied; it is applied shortly after. After that the image paths return 404. To delete the current avatar without knowing its filename, call DELETE /domains/{domain}/users/{user}/avatar. Only GET and DELETE are served on this path; POST and PUT return 405 Method Not Allowed. Upload to the avatar collection path, not to a filename.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟠404Record not found

application/json

The resource does not exist, or your token cannot see it.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🔴503Service Unavailable

🟢202Accepted

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

404 - Example 1

{
    "code": 0,
    "message": "string"
}

Modified at 2026-10-09 00:52:04

Read user avatar by filename

Read user avatar