Create image

POST

/images/{filename}

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

OperationId:CreateImage

Stores a new image under the name in the path, for a reseller, a domain, a server, or all of them. Send the file as a multipart part, or as base64 in a JSON body.

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. If an image already exists under this name for the same reseller, domain, and server, the request returns 400; replace it with PUT /images/{filename}.

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. The request can be at most 64 MB.

Send reseller and domain in the body; query-string values for them are ignored. The request returns 202: the image is accepted and stored 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

multipart/form-data

Required

Responses

🟢202Accepted

application/json

Accepted. The image is stored shortly after. Read it with GET /images/{filename} to confirm.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠413Content Too Large

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/images/logo.png' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""' \
--form 'reseller="example-reseller"' \
--form 'domain="*"' \
--form 'server="*"' \
--form 'description="Portal login logo"'

Response Example

202 - Accepted

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

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

Update Image from Upload (Multipart/Mixed Post)

Update image