Read avatar image by size

GET

/avatar/{size}/{filename}

Last modified:2026-09-28 22:52:03

OperationId:GetAvatarImageBySize

Serves an avatar image in the size you name: a user's, a contact's, or a generic one. path, path-small, and path-large in the avatar reads point here.

No authentication is needed, so an <img> tag can load it directly. Anyone who has the filename can load the image.

Images are stored as WebP. Ask for the same name with .jpg or .png and you get a JPEG or PNG copy, converted on first request and kept on disk; a JPEG has a white background in place of transparency. The answer carries Cache-Control: public, max-age=2592000 (30 days), Expires, Last-Modified, and a strong ETag. Send If-None-Match or If-Modified-Since to get a bodyless 304 while your copy is current. A filename never changes content, so a new avatar has a new filename; a deleted avatar returns 404 here, but copies already cached by browsers or proxies can outlive it by up to 30 days.

Request

Path Params

Responses

🟢200Image bytes

image/webp

The image: image/webp, or image/jpeg or image/png for a .jpg or .png name.

🔵304Not Modified

🟠404Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/avatar/256/5f0c2d8e9b7a4c1d3e6f8a0b2c4d6e8f.webp'

Response Example

404 - Example 1

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

Modified at 2026-09-28 22:52:03

Read avatar image

List available locales