Add generic avatar

POST

/avatar

Last modified:2026-10-30 21:22:26

OperationId:AddSharedAvatar

Adds an image to the generic avatar library that GET /avatar lists. Every call adds a new image; none is replaced. Requires Super User scope. Send the image as multipart/form-data in a part named file. To remove one, call DELETE /avatar/{filename}.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params multipart/form-dataRequired

Responses

🟢202Accepted

application/json

The change is accepted and applied shortly after: the image is added to the library, so path can return 404 for a moment. user and domain are *.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/avatar' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""'

Response Example

202 - Generic avatar added

{
    "filename": "0e4a6c8b2d1f3a5c7e9b0d2f4a6c8e1b.webp",
    "user": "*",
    "domain": "*",
    "path": "/ns-api/v2/avatar/0e4a6c8b2d1f3a5c7e9b0d2f4a6c8e1b.webp",
    "filetype": "image/webp",
    "filesize-large-bytes": 7852,
    "filesize-small-bytes": 1026,
    "path-large": "/ns-api/v2/avatar/256/0e4a6c8b2d1f3a5c7e9b0d2f4a6c8e1b.webp",
    "path-small": "/ns-api/v2/avatar/48/0e4a6c8b2d1f3a5c7e9b0d2f4a6c8e1b.webp",
    "file-modified-for-limits": "no"
}

Modified at 2026-10-30 21:22:26

Add generic avatar using PUT

Delete generic avatar