Update domain brand asset

PUT

/domains/{domain}/brands/{hostname}/{brand_name}/assets/{asset_type}

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

OperationId:ReplaceAssetImageDomainScoped

Replaces the image of an asset of a brand scoped to the domain, renames it, or both. Requires Reseller or Super User scope. A Reseller reaches only the domains in its own territory. The reseller is taken from the domain.

Send image-data or a file part to replace the image, and filename to rename it. The asset type comes from the path.

JSON: image-data holds the image as base64.

Multipart: a multipart/form-data body with the image in a part named file, and the other fields as text parts. The part's file name becomes filename unless you send one.

The image must be a PNG, a JPEG, or an SVG of 5 MB (5,242,880 bytes) or less, measured after base64 decoding. An SVG must declare width and height on its root element. mime-type, width, height, and file-size-bytes are read from the image.

The response is 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

The change is accepted and applied shortly after.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

cURL

Replace the imageRename only

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//brands/portal.example.com/Blue Theme/assets/logo' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "image-data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==",
    "filename": "logo-2026.png"
}'

Response Example

202 - Replace the image

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

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

Read domain brand asset

Delete domain brand asset