Update image

PUT

/images/{filename}

Last modified:2026-10-03 17:35:18

OperationId:UpdateImage

Replaces the file of an image already stored under the name in the path. Send the new file as base64 in a JSON body, or as a multipart part.

Requires Super User or Reseller scope. A Reseller can manage images stored for its own reseller or for a domain in it. An image that applies to every reseller and every domain (reseller and domain both *) is platform-wide, and only a Super User can create, change, or delete it. Other scopes get 403.

An image is stored per reseller, domain, and server, and each defaults to *, meaning all. The values are matched exactly: an image stored for every domain is not found when you name one domain. Name the same reseller, domain, and server the image was created with. Every update must carry a file; description cannot be changed on its own. An email template stored under the same name cannot be replaced here.

The file must be a PNG, JPEG, GIF, WebP, or ICO image. Both the declared media type and the file's contents are checked, and the type detected from the contents is the one stored. SVG and other types return 400.

Send reseller and domain in the body; query-string values for them are ignored. The request returns 202: the change is accepted and applied shortly after.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params

application/json

Required

Examples

Responses

🟢202Accepted

application/json

Accepted. The new file is stored shortly after.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

🔴507Insufficient Storage

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/images/logo.png' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "file-base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
    "file-mime-type": "image/png",
    "reseller": "example-reseller",
    "description": "Portal login logo"
}'

Response Example

202 - Accepted

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

Modified at 2026-10-03 17:35:18

Create image

Read template