Delete shared contact avatar by filename

DELETE

/domains/{domain}/contacts/{contact_id}/avatar/{filename}

Last modified:2026-09-28 22:51:40

OperationId:DeleteDomainContactAvatarFile

Deletes one stored avatar of a shared contact of the domain, addressed by its filename, and clears the contact's avatar.

Needs domain tier or above, as for the shared contact itself: Office Manager can delete the avatars of its own domain's shared contacts, Reseller those of domains in its territory, and Super User any domain's. Scopes that can only read shared contacts, including Site Manager and Call Center Supervisor, get 403.

The contact must be in the address book the path names, and the avatar must belong to it, or the call returns 404. 202 means the delete was published over the service bus (SBUS), not yet applied; it is applied shortly after. To delete the contact's current avatar without knowing its filename, call DELETE /domains/{domain}/contacts/{contact_id}/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.

After the delete is applied, the image paths return 404.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟠400Bad Request

application/json

Path contains missing parameters: a path segment is empty. Fill it in and retry.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🔴503Service Unavailable

🟢202Accepted

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/domains/example.com/contacts/0c4e8a2f6b1d9e3a7c5f0b8d2e6a4c1f/avatar/1a79a4d60de6718e8e5b326e338ae533.webp' \
--header 'Authorization: Bearer <token>'

Response Example

400 - Example 1

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

Modified at 2026-09-28 22:51:40

Read shared contact avatar by filename

Read avatar image