Delete image

DELETE

/images/{filename}

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

OperationId:DeleteImage

Deletes one stored image.

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 reseller and domain in the request body; query-string values for them are ignored. With no body, the request targets the platform-wide image, which only a Super User can delete. An email template stored under the same name is not deleted here.

The request returns 202: the image is removed 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

Examples

Responses

🟢202Accepted

application/json

Accepted. The image is removed shortly after.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/images/logo.png' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "reseller": "example-reseller",
    "domain": "*",
    "server": "*"
}'

Response Example

202 - Accepted

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

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

Read image

Create image